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SECTION 1 _ 
INTRODUCTION 


THE CMS CONCEPT 


CMS (Computer Management System) software is a powerful set of software items designed to operate on 
a number of different hardware products. 


To the user of an individual hardware product running CMS software, there is a well-defined operator inter- 
face and set of programming languages. The importance of CMS ‘is that the same user may use a different hard- 
ware product running CMS software, and with the same languages. This portability eliminates major operator 
retraining between different CMS products. It also allows freedom of interchange of programs between hardware 
products, limited only by availability of hardware features. For example, a program may be developed and com- 
piled on one system, and run on another. Also, because the compilers are also programs, there is portability 
of compilers between hardware systems as well. Data files are similarly transferable from one system to another. 
This portability is achieved by building on the “soft machine” concept. Refer to figure 1-1. 


SOURCE 
PROGRAM 


COMPILER 


OBJECT 
CODE 
PROGRAM 
(S-CODE) 


" INTERPRETER : INTERPRETER 
A B 


HARDWARE HARDWARE 
A B 


SOFT MACHINE A SOFT MACHINE B 


Figure 1-1. CMS Portability 
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The programmer writes a program in a high-level language. The CMS programming languages are: 
COBOL 
RPG (including RPGII) 
MPL (CMS Message Processing Language) 
NDL (Network Definition Language). 


This program is writen in ‘source code‘. This is then input to one of the CMS compilers which converts it 
to “‘object code”’ or “‘S-code’’. This is the executable program. The ‘“‘S-code”’ is similar in design to the ‘“‘machine 
code” of earlier generations of computer. 


In earlier generations of computer this ‘ ‘S-code’”’ would be executed by hard-wired instructions. With the ad- 
vent of fast micro-processor computers, however, it is possible to build a set of micro-instructions which inter- 
prets each “‘S-code” and executes it. The set of micro-instructions is therefore called an “‘interpreter’. The com- 
bination of interpreter and micro-processor hardware is sometimes termed a “‘soft machine”’. 


Now as the “‘S-code”’ is independent of any particular hardware, it is possible (and has been achieved in CMS) 
to build several soft machines which will execute a “object program” in a similar manner. Hence the CMS ob- 
ject programs are portable across the different CMS machines. 


These machines include: 


B 90 
B 1800 
B 1900 


There are different CMS interpreters on each system. For example, on the B90 the interpreters are: 


BILINTERPX 
COBOLINTX 
NDL.INTERPX 


BILINTERPX is used to execute programs written in MPL and in BIL (an implementation language used 
for compiler-writing which is so similar to MPL that they share the same S-code format), COBOLINTX is 
used to execute programs written in COBOL and RPG (these two languages share the same S-code format). 
NDL.INTERPX is used to interpret data communication controller programs written in NDL. 


Certain common features needed in all programs (such as the handling of peripheral devices) have been collected 
together into: a Master Control Program (MCP). The MCP is a micro-code program and is therefore specifically 
written for each hardware product. Thus there is a B90 MCP, a B 1800 MCP and a B1900 MCP. The MCP also 
controls the operator interface (which is standard across the CMS range) and mainhains overall control of the system, 
providing complete resource management including multi-programming, I/O device handling and memory manage- 
ment. 


CMS software also provides a number of utility programs. As these are written in MPL, they also are portable 
across the CMS range, limited only by hardware feature availability. 


To cover the complete features of each CMS product line, certain aspects of the software are written for a 


specific product. These additional features include important operational characteristics, and are described in 
sections 8 through 10. Sections 2 through 7 of this manual cover items which are applicable to any CMS product. 


1—2 


SOFTWARE RELEASE LEVELS 


Each item on a CMS software release is identified by a three-part number, as follows: 


X. XX. XX 


—_ patch number 
level number 


mark number 


The mark and level numbers constitute the release number. For example, the COBOL compiler 3.01.08 is 
the COBOL compiler included in the 3.01 release of system software, with patch number 08. 


Software items from different releases should not be used together. For example, an interpreter from release 
3.01 should not be used with an MCP from release 3.00. 


This book describes system software relative to the 3.02 release. 


Software Patches 


Within a particular release, patches to individual items may be issued. For example, an MCP identified by 
3.01.12 contains certain improvements over an MCP identified by 3.01.11. A patch always increases the patch 
number. It is always advisable to use the highest patch versions within any one release. All system software 
items within a given release (mark and level numbers) may be used together, regardless of the patch number, 
unless explicitly stated otherwise at the time of release of the item. 


Certain items may be patched by the user. The details are machine-dependent and are described in the rele- 
vent section (8 through 10). 


SOFTWARE SUPPORT 


Throughout this book, suggestions are made for corrective action where possible, following a particular output 
message or symptom of failure. Sometimes the phrase “request technical assistance”? has been used. This should 
be interpreted as a recommendation to contact your immediately higher support level if you are not sure of 
what to do or do not feel justified in attempting further action without competent advice. 


All problems with the system should be recorded. This is for two purposes: to report the problem; and to 
avoid similar problems in the future. The report should contain the date and time and list the systems. As a 
minimum it is recommended that the SPO hard-copy printout or SPO log is kept for future reference. 


TO THE READER 


This book is written as reference material. It is a guide to be consulted during operation of any CMS machine. 


This book explains how to start and to stop the system software. As this is normally hardware-dependent, 
the relevant section (8 through 10) should be consulted. 


Once the system software has started (that is, the system is under MCP control), the operator may interface 
with the MCP via the SPO (Supervisory Printout) device in order to execute programs. The type of device may 
vary with the hardware product, but input and output messages are standardized. 


Section 2 of this book explains some general terms which should be understood in order to make full use 
of the CMS features. It explains how to cause programs to be executed. This section also explains how to read 
the diagrams used throughout the book to describe the format of input messages and other details. 


Details of input messages are given, in alphabetical order, in sections 3 and 4. The items in section 4 are 


utility programs which are executed in the same manner as other programs. The items in section 3 are embedded 
features in the MCP. Refer to section 2 for a fuller explanation. 
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Sections 5 and 6 describe the sort/merge feature and the compilation feature respectively, and will be of spe- 
cial interest to programmers. Section 5 includes a functional description of the sort/merge feature. 


Section 7 lists the messages which may be output to the SPO by the system software during execution of 
the system. As each message is identified on the SPO by a number, reference to this book can be made by 
this number. 7 


For other items such as hardware and system software failures, refer to the particular hardware section (8 
through 10) for details. 


SECTION 2 


BASIC CMS OPERATION 


INTRODUCTION 


All CMS operation has two basic principles: it is disk-based; and operator communication is with the MCP 
by a SPO device. Other peripherals may be present, depending on the configuration. This section introduces 
some basic principles which should be understood by all CMS operators. The material in this section is common 


to all CMS products. Other details that are machine-dependent are given in the relevant section. 


PERIPHERALS 


Each peripheral is referenced by a three-character abbreviation, where the first two characters give the type 
of peripheral and the third character refers to the particular peripheral by the letter A, B, and so on. For exam- 
ple, LP is the abbreviation for a line printer, so the first line printer is referred to as LPA, and the second 


is LPB. 


The peripheral types are listed below: 
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AC — console with any output device 
AM -— any multi-function card unit 

AP — any (serial or line) printer 

AR — any card reader 

AT - any magnetic tape 

CP — any card punch 

CT —- cassette tape 

DC — data communications controller 
DF - fixed disk 

DI — industry-compatible mini-disk (ICMD) 
DK -— disk cartridge (any type of speed) 
DM — Burroughs super mini disk (BSMD and BSMDII) 
DP — disk pack 

KB — Keyboard 

LP -— line printer 

MT — magnetic tape (reel) 

M8 — 80-column multi-function card unit 
M9 — 96-column multi-function card unit 
PC —- console with serial printer 

P8 — 80-column card punch 

P9 — 96-column card punch 

R8 — 80-column card reader 

R9 — 96-column card reader 

RS — Reader Sorter 

RT -— Real Time Clock 


SC — console with SELF-SCAN ® device 
SD - Screen Display 
SP — serial printer (on console) 
SS - SELF-SCAN ® device 
If the configuration contains more than one device of the same type, the designation (A, B, and so on) de- 
pends on the location of the peripheral controller in the hardware. If there is only one dual-drive cartridge con- 
troller, the upper drive is DKA and the lower drive is DKB. If there is only one dual-drive Burroughs super- 


mini- -disk controller (for example, on a small B 80 with in-built mini disk), the upper drive is DMA and the 
lower drive is DMB. 


The three-character references are used in all operator communication with the MCP (refer to section 3). 


SYSTEM AND USER DISKS 


The MCP resides on a disk unit. At warmstart time (when the system is started up and the MCP begins to 
function) the MCP notes the disk containing the executing MCP code. This is called the “‘system disk’’. 


During operation there is only one system disk. Other disks may contain a copy of the MCP code, but only 
the disk from which the MCP is running is the system disk. 


All other disks on the system during machine operation are called “user disks’. 


There is one restriction on the portability of system disks between different CMS products. A system disk 
may not be taken to a different CMS product and used there as a system disk. It may, however, be used on 
the second system as a user disk. It may also be used on the first system as a user disk. User disks may always 
be interchanged between different systems. 


DISK FORMAT 


_ A disk consists of one or more platters, one or both surfaces of which may be used to record sou The re- 
cording area of disks is divided into the following physical items: 


Track: 


An area of one surface of a disk which is at the same distance from the center of the disk. The entire track 
can be accessed without moving the position of the read/write head. 


Sector: 


The basic unit of disk address, size 180 bytes on all Burroughs disks, and 128 bytes on ICMD. A physical 
read or write uses a complete sector. There are several additional bytes in each sector, used only by the hard- 
ware and not accessible to user programs. The sector is also called a “‘segment”’. 


Cylinder: 
If there is more than one surface, each track at the same distance from the center makes a cylinder. The 
entire cylinder may be accessed without altering the position of the read/write heads. 


Figure 2-1 illustrates these terms. 


Disk Initialization 


Each disk must be initialized before use on a-‘CMS machine. Initialization creates correct sector addresses 
throughout the disk recording surface, then writes certain data in the low-address part of the disk. The first 
sector is numbered sector zero, and the first track is numbered track zero. A disk with a bad track cannot be 
initialized. The method of initializing the disk is machine-dependent refer to the appropriate section. 


Sector zero contains the disk label. This includes the name of the disk, or “‘disk-id’’. Every disk has a disk- 
name. This disk-name can be from one to seven characters, using the set A to Z, 0 to 9, and the dot (‘‘.’’) 
and hyphen (‘~’). 

SELF-SCAN ® isa registered trademark of Burroughs Corporation. 
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TOP VIEW : 


ONE TRACK, MADE OF 
SEVERAL SECTORS 


ANOTHER TRACK, MADE OF THE 
SAME NUMBER OF SECTORS 


SIDE VIEW : 


, wv ONE CYLINDER 


lt occu 
READ/ 


Figure 2-1. Physical Disk Structure 


Disk Files 


Information is stored on a disk in a ‘“‘disk file’. There may be many files on one disk. Each file is referenced 
by a “file name’”’. A file name can be from one to twelve characters, using the set A to Z, 0 to 9, and the 
dot and hyphen. Each disk contains a directory of the files on that disk. This directory is accessed by utilities 
such as KA and PD (see section 4). | 


Information can be of different types: normal data, accessed by programs; special data, accessed by the MCP; 
and programs themselves. The MCP is itself a program, and so are other “‘system files’ such as the interpreters. 
System files have special restrictions in that a control is placed on their removal (see RM section 4). 


Disk File Names 


On any system, every disk file (whether data or a program) is accessed by a two part reference, as follows: 
disk-name/file-name 


For example, the disk file M101A/REP200 is a file with a file-name REP200 to be found on the disk with 
a disk-name MIOIA. 


It is not necessary to give the name of the system disk when referring to files residing on the system disk. 
Alternatively, a disk-name of 0000000 by convention refers to the system disk. For example, the disk file 
REP200 or 0000000/REP200 is a file with a file-name REP200 to be found on the system disk. 


It is not allowed to have two disks of the same disk-name in use at the same time. It is not allowed to have 
two files of the same file-name on the same disk. However, it is quite permissible for two different disks to 
contain a file with the same file-name. For example, the files M100A/REP200 and M101A/REP200 refer to two 
different disk files (although one may be a copy or update of the other). 
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Disk File Group Names 


In many utilities (see section 4) it is convenient to refer to groups of files, depending on common starting | 
characters of their file-names. 


All files on a disk may be referenced by the equals symbol (‘“‘=’’). For example, the reference M101A/= 
refers to all files on the disk with disk-name MIO1A. 


All files beginning with, say, the characters REP may be referenced by REP=. For example, the reference 
M101A/REP= refers to all files on disk M101A with file-names of REP200, REPA, REP678P, and so on. 


In general, a group-name consists of an equals symbol (‘‘=’’) optionally preceded by up to ten symbols which 
are the first part of the file-names of each of the files in the group. 


Example: 


Consider a disk M101A containing files with file-names: 
PR200,REP100,REP200,REP250,RQ510,CRCOPY 


Then the following group-names refer to the files indicated: 


M101A/= 

PR200, REP100, REP200, REP250, RQ510, CRCOPY 
M101A/REP= 

REP100, REP200, REP250 
M101A/R= 


REP100, REP200, REP250, RQ510 


Disk Directory 


The disk directory is a table on every CMS-initialized disk which.enables the MCP to locate any disk file by name. Full 
details of the directory layout are given in the CMS MCP manual. 


The directory is a fixed size determined at disk initialization time, based on the maximum number of files 
to be placed on the disk. An attempt to create more files than there are entries in the directory will give 
an appropriate MCP run-time error message, 


The directory consists of three parts: 
the name-list 
the disk file headers for each file 
the available table 


The relationship between these parts are given in figure 2-2. The name-list is a list, by file-name, of each 
file existing on that disk. A search through this name-list will reveal if a file is present or not: if present, the 
-name-list entry points to the disk file header for the file. This is a table giving the location of each part of 
actual data in the file (the file may be divided into up to sixteen separate physical areas on the disk). In the — 
figure only one area is indicated. The available table is a list of the disk areas not in use by a file. When a 
new disk file is created, an available space is found from this table and an entry made in the name-list, then: 
the space is used to write the file information. When a disk file is removed its entry is deleted from the name- 
list and the areas specified in the disk file header are entered in the available table. 


If there is insufficient space on a disk to allocate new disk file areas, a “NO USER DISK” message is given 
by the MCP. The operator may remove a file (see RM) to make more space available. The KA utility (see 
section 4) and KX function provide information on the available space on a disk. | 
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TRACK 0 


DISK FILE: 
HEADERS 


DISK SPACE 
FOR FILES 


Figure 2-2. Disk Directory Structure 


_ As a simplification, it may be stated that when a disk is initialized the directory is rebuilt with no entries, | 
indicating that the entire disk space is available apart from the directory itself. In fact, any bad areas on the 
disk are marked in the directory so that they cannot be allocated to files (see also the XD utility); also, there 
is a special entry called “SYSMEM” which enables certain programs such:as PD and RM (which access the 
directory) to operate successfully. 


Indexed Files 


Indexed files are in fact a pair of files, the‘‘‘key file’? and the “data file’. They may reside on the same or 
separate disks. Each file in the pair has a separate entry in the disk directory of the disk on which it resides. 
A special table at the beginning of the key file (the‘‘‘key file parameter block’’) gives, among other information, 
the disk-name and file-name of the associated data file. See figure 2-3 for a diagram of the relationships between 
the two files. | 


The purpose of indexed files is to simplify access to data in the data file by using a set of keys (such as ac- 
count number) in each record of the data file. These keys are placed in the key file. A key file may be created 
by the SORT utility and intrinsic (see section 5, where examples are given). | 


Special consideration must be given to copying indexed files, due to the link between the key file and data 
file. This is especially true when copying from one disk to another. Details are given in each relevent section 
(see COPY utility, section 4; also the machine-dependent copy facilities). 


Dual Pack Files 


As mentioned before, a disk file may be divided into up to sixteen separate areas. If these areas are located 
on two separate disks the file is known as a‘‘dual pack file’. Such files may be created by the AD intrinsic 
in response to a“NO USER DISK” message (see section 3). 


There is an entry in the directories of both disks for a dual pack file, together with the disk-name of the 
other disk. Each disk directory has a copy of the disk file header for this file, but the table of locations for 
each file area also indicates if the area is located on‘‘this” disk or the“‘other’” disk. This is shown diagrammatical- 
ly for a file with four areas in figure 2-4. In most applications it is necessary for both disks of a dual-pack file 
to be on-line at the same time. | 
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DISK LABEL OF DISK 
WITH DATA FILE 


DIRECTORY ENTRY 


DIRECTORY ENTRY 
FOR KEY FILE 


FOR DATA FILE 


DATA FILE 
DISK-NAME 


DATA FILE : 
FILE-NAME 


KEY FILE DATA FILE 


Figure 2-3. Indexed Files 


DISK LABEL OF DISK 


DISK LABEL OF DISK 


A B 


DIRECTORY ENTRY DIRECTORY ENTRY 
FOR DUAL-PACK FILE FOR DUAL-PACK FILE 


AREA 4 


DISK A | DISK B 


Figure 2-4. Dual-Pack Files 
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MAGNETIC TAPE FILE NAMES 


Note: this includes tape cassette. 


A tape may be used to store data either on one file (a ‘‘single-file tape’) or as a ‘“‘multifile tape’’. Each file 
is separated by a tape mark. Additionally, each file normally has a beginning and an ending label. A multifile 
tape has also a special beginning (‘“‘volume’’) label. 


On loading a tape, the MCP reads the first label to determine the tape name. Tape file names are in two 
parts: 


multifile-name/file-name 


For a single-file tape, the multifile-name will be “0000000”. The format of the multifile-name is the same 
as for the disk-name of a disk file. 


The COPY utility (section 4) produces a single-file tape when copying to tape. The LD utility (section 4) 
always produces multifile tapes called “library tapes’’. Library tapes are referenced by the multifile-name: there 
is a standard convention for labelling all the files on a library tape. For full details of tape formats, refer to 
the CMS MCP manual. 


Tapes (multi-file or single-file) may be unlabelled. Such tapes must always be accessed via the AD intrinsic 
(section 3) because there is no label that the MCP can recognize when the tape is loaded. Tapes containing 
labels that are non-standard are also treated as multifile unlabelled tapes. 


PRINTER FILES 


There are two types of printer: a wide line printer and a console printer, depending on available hardware. 
The console printer is also known as a “serial printer”. These hardware devices are also referred to as “files” 
and are given file-names of up to seven characters. When the file is opened and closed, an identifying print 
line is given to indicate the name of the file. This file-name is also used in MCP messages. Refer to the CMS 
MCP manual for full details. 


It is possible to designate a file type of “‘any printer’. Such a file will be written to a wide line printer if 
this peripheral is available. If not available, this file will be written to the console printer if available. If there 
is no console printer either, the MCP will display a “NO FILE” or “DEVICE REQUIRED” message. 


OTHER PERIPHERALS 


All peripherals are treated as files for input, output or a combination of input/output, depending on the hard- 
ware type. The use of any periphral device is governed by the file-name of up to seven characters, which will 
appear in any related MCP messages. Refer to the OL intrinsic (section 3) for other details. 


PROGRAMS 


An executable program is information stored on disk as a disk file. It is referenced in the same way as any 
data file: that is, through the disk-name and file-name (or just the file-name if the program resides on the system 
disk). The rules for the program name are the same as for any disk file name. 


A “utility” is a program provided for general use by all CMS operators, for house-keeping and other general 
purposes. For example, the LD utility enables operators to load and dump disk files from disk to magnetic tape 
for backup purposes. 


Executing Programs 


In order to execute a program, part or all of the information in the disk file must be brought into memory 
and placed under control of the MCP. This is called “program load‘, and takes a certain interval of time. 
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Programs may be loaded and executed by merely providing the name of program file to the MCP. If so de- 
sired, the keyword “EX” may be place before the program name. For example, suppose one wishes to execute 
a program that resides on a disk PR200A in a file called DCS. Either the input 


EX PR200A/DCS 


or just 
PR200A/DCS 


will cause the program to be loaded and executed. 


Depending on the system, a BOJ (beginning-of-job) message may be displayed by the MCP after the program 
has been loaded, and a EOJ (end-of-job) message may be displayed by the MCP at the end of the program. 
The display of these messages may be turned on or off for individual programs by the MODIFY utility (see 
section 4). 


Failures may occur when attempting to load a program. For example, the requested program may not be on 
disk. A list of load failure messages is given in section 7. 


Many programs enable the operator to enter further information after the program name. This is known as 
an “‘initiating message” and the contents are entirely dependent on the program. Nearly all the utilities in section 
4 allow further information, the format of which is given in the description of each utility program. For example, 
the input 


COPY REP202 TO RPTAPE 


consists of the command to load and execute the program called ““COPY” (found on the system disk in this 
example), followed by the information ““REP202 TO RPTAPE” which is passed to the program. There are two 
types of error which can be made: either there is a load failure (because, for example, the COPY program 
is not on the system disk), when the MCP would issue an appropriate message; or the following information 
is an incorrect format for the program, when the program itself would issue a message. In the former case, 
the MCP message is described in section 7. In the latter case, the output message is described under each utility. 


Note that if the utility resides on, say, the disk PR2, the input message would be 
PR2/COPY REP202 TO RPTAPE 


or 
EX PR2/COPY REP202 TO RPTAPE 


In section 4 this additional information is omitted in the interest of clarity. It is, however, common for utilities 
to reside on a disk other than the system disk, in which case the disk-name must be provided. 


It is also possible for programs to be automatically executed by another program. In this case, the first pro- 
gram is said to “zip” the second program. No operator input is used in this case, but the BOJ message may 
be displayed for the zipped program. 


INTRINSICS 


There is an important type of operator input that does not involve a command to execute programs or 
utilities. These messages are calls on “‘intrinsics’’ which are part of the MCP. Those intrinsics which are common 
to all CMS machines are described in section 3. Other intrinsics are given in the relevent machine-dependent 
section. | 


Because an intrinsic is part of the MCP, there is no separate program corresponding to the name of the intrin- 
sic. Therefore the keyword “EX” is not allowed in a call on an intrinsic, neither can a user disk-name be 
specified. There is no program load time because the MCP is already executing. For example, the input 


RY DMA 


is a request to the MCP to ready (RY) the disk peripheral designated by DMA. This input message to the 
MCP must not be preceded by the keyword “EX’’. 
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MIX NUMBERS 


AS a program is loaded, the MCP assigns it a number from its table of executing tasks. This is the ‘“mix- 
number” and is used in any messages output by MCP relating to this task. The mix-number is also used in 
all messages input by the operator for this task. Some input messages also require the corresponding program 


name as well as the mix-number. The MX intrinsic (see section 3) may be used to determine the current mix 
of tasks. 


The allocation of mix-numbers is dependent on the CMS product. Refer to the corresponding section for more 
details. 


OUTPUT MESSAGES 


As mentioned earlier, messages may be output on the SPO either by the. MCP and other system software 
or by the program. It is important to distinguish between the two types of output messages in order to look 
up the message in the appropriate place. 


Messages output by the MCP are of two kinds: short responses to intrinsics, and longer descriptions of any 
event to be brought to the attention of the operator. The short descriptions are self-explanatory: for example, 
the input message 


OL LPA 


(an intrinsic to inquire of the status of line printer LPA) may result in the response 
LPA READY 


Similarly, the short message 
LPA NOT READY 


will be displayed if LPA is stopped by the operator or through any fault. The longer descriptions are always 
referenced by an “event number”’ enclosed in brackets. The format of these messages is given in section 7, and 
operators should be generally able to recognize that such a message has been output by the MCP. 


For example, the message 
10/LIST <17> WAITING UNLAB LISTPRT AP NO FILE 


indicates an MCP message with event number 17, and reference should be made to section 7 for information 
on possible causes and suggested actions to take. 


Messages with event numbers may also be output by other parts of the system software such as interpreters 
and the sort-intrinsic, although the overall format is similar. After recognizing the event number, reference 
should be made to section 7 (or section 5 for sort-related messages). 


Messages output by all other programs are known as “displays”? and may be preceded by the keyword 
“DISP”. Note, however, that utility programs may display messages without this preceding keyword. 


All messages output by the utility programs described in this manual are listed under the respective utility. 
For example, messages displayed by COPY utility are listed under the COPY utility. Messages may additionally 
be displayed by the MCP for events related to the execution of the COPY utility (for example, if the COPY 
utility needs space on a particular disk, a “NO USER DISK” message will be output) but these MCP messages 
will always be distinguished by the event number. 


Messages displayed by other programs are not discussed in this manual. Reference must be made to the ap- 
propriate manual or operating instructions for that program. 


Figure 2-5 illustrates a sample SPO list giving a mixture of messages described in this section. Note in this 
example that the utility programs LIST and LR do not give rise to BOJ and EOJ or DISP messages. The user 


program PROGA shows all three messages. These messages may be turned on for utilities by using the 
MODIFY utility (section 4). 
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input commanc to run LIST -"> 
MCP output message event 10-> 
input command to run PFOGA => 
MCP message for PROGA BOJ ==> 
input commanc to run LR -<<=> 
next Line is PROGA display “™> 
actuat disptay information => 
input request Ot intrinsic “> 
MCP response to OL message ™> 
finput request MX intrinsic => 
MCP response to MX message ™> 
-> 

-> 

-> 

MCP messaae for PROCGA EOJ ==> 
input request ST intrinsic => 
IMCP response to ST wessage => 


LIST COLLETTE 
O1/LIST <1C> WAITING COCLLETTE Ok NO FILE 
PROGA 
O2Z2/PROGA BOJ PR IS A 
LR = 
O2/PROGA DISP: 
PROGRAM A VERSION 7.C1-05 
OL LFA 
LPA LRPRINT IN USE BY C3/LR 
MX 
OCL1/LIST SUSPENDED WAITING CN AO FILE 
ee CONDITION 
O2/PROGA A EXECUTING 
OS3/LR B EXECUTING 
QZ2/PROGA ECJ 
ST 23 
O3/LR STOPFED 


Figure 2-5. Sample SPO List 


FORMAT DIAGRAMS 


Most of the descriptions of input messages in this book are given as simple format diagrams with correspond- 
ing descriptive text and examples. An example will illustrate how to read such format diagrams. 


EX | disk-name / | TST200 | number | 
TST201 


In this format, items in lower-case (‘‘disk-name” and “number” in this example) are to be replaced by actual 


Example: 


values (such as ““PR2” and ‘“27’”). Other items are included in the input message as they are found. Spaces 
are required whenever necessary to avoid ambiguity. In the example, it is not strictly necessary to separate the 
_disk-name and the slash **/”) with a space because the slash cannot be part of the disk-name according to the 
rules for disk-names. Extra spaces may however, be added for legibility. If an arrow in the left-to-right direction 
is encountered, the items under the arrow may be omitted. Curly brackets are used to denote alternatives. The 
alternatives are placed in a list underneath each other. (Each alternative item may be more complex than the 
example quoted: it may contain optional parts and further alternatives). If an arrow in the right-to-left direction 
is encountered, one may return to the point underneath the arrow and continue building up a valid input mes- 
sage In the example quoted, after adding a valid number (say ‘“‘27’?) one may return to add a second number 
(say ‘‘52”). In fact, the format diagram does not specify how many times one may continue to do this, but 
details are given in the text. 


Here are several valid input messages which can be generated from the example. (Note that a disk-name can 
consist of up to seven characters, see earlier): 


EX TST200 57 
EX TST201 259 

EX PR2/TST200 36 

EX PR2/TST200 2 52 574 361 
EX MI101A/TST201 1 2 
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Here are several invalid input messages according to the example: 
EX PR2/TST200 
EX PR2 TST200 36 
EX TST202 36 
TST201 259 
EX PR2/M101A/TST201 1 2 


Here is a slightly more complicated example, which makes the number or list of numbers optional: 


4 | disk-name / 1 TST200 t | number | 


Example: 


TST201 


The input messages 
EX PR2/TST200 
EX PR2/TST200 56 
EX PR2/TST200 27 56 


are now all valid. 


_ These simple format diagrams are easy to understand in conjunction with descriptive text and examples, but 
cannot be used if the format becomes too complex. In the latter case a rigorous notation known as “railroad 
diagrams”’ is employed (see below). In some case in the text of this book, the format has been deliberately 
simplified for the sake of clarity, with further details given in the text. More complex features have been de- 
scribed by railroad diagrams (see, for example, the COPY and LIST utilities in section 4). Appendix B gives 
complete railroad diagrams as a handy reference for those who need the exact definition of any input message. 


RAILROAD DIAGRAMS 


The equivalent railroad diagram to the first format diagram is given in figure 2-6. 


<disk-name> — / 
| TST200 
£X “<number > 
TST201 
Figure 2-6. Railroad Diagram Sample 1 


To form valid input, follow the railroad “‘track” from left to right or in the direction of the arrows. A junction 
in the track indicates that alternative paths may be followed. Items enclosed in angled brackets “<” and <>”) 
must be replaced with actual values, as before. Each item not enclosed in angled brackets is included as it is 
found. Spaces are added where necessary, as in format diagrams. 


The equivalent railroad diagram to the second format diagram is given in figure 2-7. 


<disk-name > ~~ / < number > 
TST200 
EX 


TST 201 


Figure 2-7. Railroad Diagram Sample 2 
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There are two other features available in railroad diagrams to make possible the exact specification of any 
input message. These are illustrated in figure 2-8. Firstly, the maximum number of times around a loop may 
be controlled by including the number 


<disk-name> — 


< number > 
TST200 


TST201 


Figure 2-8. Railroad Diagram Sample 3 


in the track of the loop. In the example, it is possible to omit the <number>, or to include either one or 
two values of <number>. Secondly, if angled brackets are to be included as part of the message, these must 
be underlined. In the example, there is an optional part of the message which consists of the three characters 
“<A>”. The following messages would then be valid: 


EX PR2/TST200 

EX PR2/TST200 27 

EX PR2/TST201 27 56 
EX PR2/TST201 <A> 
EX PR2/TST200 <A> 56 


but the following would be invalid: 
EX PR2/TST200 27 56 243 
EX PR2/TST201 A 
EX PR2/TST201 A 73 


Note also that if a number under a loop is preceded by an asterisk (“ * ”’), then that loop must be included in the syntax 
at least the number of times specified. For example, if the loop included the characters “ *1”, then the loop must be included 
at least once. 
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SECTION 3 
CMS-COMMON INTRINSICS 


INTRODUCTION 


This section describes, in alphabetical order, those input commands which are embedded in (“‘intrinsic to’’) 
the MCP, and which are common to all CMS products. 


As discussed in section 2, it is not valid to precede these messages with ‘“‘EX”’’, because the intrinsics are not | 
separate programs to be loaded and executed. The intrinsics cannot be executed from a user disk, because by 
nature they are part of the MCP which is on the system disk. 


The response to these intrinsics may vary slightly between different CMS products, due to different hardware 
being used. These variations have been noted in the text where applicable. 
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AD (Assign Peripheral Device) 


This intrinsic allows the operator to assign a particular peripheral to a program that has called for an ‘“unla- 
belled input file”, or that requests a particular output device. 


It may also be used to allow file overflow onto a second disk if no disk space is available 


AD mix-number | / program-name peripheral 


Format: 


Example 1: 
Copy utility requires another disk: 


COPY INIST TO INDISK3/INIST 
10/COPY <12 > WAITING FILEZ10 NO 
..- USER DISK 

AD 10 DMB 


(The first message is output by the MCP and the operator responds with the AD message by assigning DMB 
as the disk to which the remainder of file INIST will be copied. This creates file INIST as a ‘“‘dual-pack file‘). 


Example 2: 
Program “COBOL7’, mix number 03, requires a line printer type device: 
03 COBOL7 <17 > WAITING LP NO FILE 
AD 03 LPA 


(The first message is output by the MCP, and the operator responds with the AD message by assigning LPA 
to mix number 03). 7 : 


Example 3: 


The LIST utility requires an unlabelled tape: 
LIST TAPE1 MTP NO.LABEL 
01/LIST <14> WAITING UNLAB SPURIUS/TAPE1 AT 
... DEVICE REQUIRED 
AD 01 CTB_ 


Output messages: 


IMES SAGE | POSSIBLE CAUSES SUGGESTED ACTION 


mix number/program Specified crogran Check with MX | 
AD INVALID was not suspended for rame of susdended 
, Waiting for a cevice progrém@e 
asSionmert. 
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AX (Accept a message for a program) 


This intrinsic allows the operator to communicate with a program in the mix. The program must already Re 
suspended waiting for an “accept”? (ACPT). 


The MCP will prompt the operator for input by printing “‘mix number/program-name ACPT”’ on the SPO. 


The maximum length of the “text”? or operator input is 50 characters. Operating intructions for individual 
programs will provide the operator with valid “text”? responses. 


AX mix-number | / program-name | text 


Format: 


Example: 


The program BMO01 displays a message asking for a file name to be entered. The operator responds with 
the appropriate text, in this case ARSCHG, by the AX message. 


BMOO1 

01/BM001 BOJ 

ENTER BM202 FILE NAME 
01/BM001 ACPT 

AX 01 ARSCHG 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


mix“number / Specified program Check with MX for 
program—name was not waitinc for orooer mix=numrber 
INVALID an “accept” and cerogram™name 
or combinétion. 
mix number and 
specified program 
name do not match. 
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CL (Clear Peripheral) 


This intrinsic allows the operator to clear the peripheral from the program and bring the program to End 
of Job (EOJ). It breaks the “links” between the program and the peripheral. 


For example, if the line printer “hangs” during the printing of a report and an attempt is made to DS the 
program, it will not be possible to discontinue the program unless the line printer is made ready or CL is used 
to break the “link” between the program and the line printer. 


Format: 
printer peripheral 
CL . tape peripheral 
self-scan peripheral 
ICMD peripheral 
Examples: 
CL LPA 
CL SSA 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


Proqra® iS not wWaittirg Check input. 
on “hung™ peripheral. 
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DC (Data Communications operator input) 


_ This intrinsic enables the operator to enter messages from the SPO to the Message Control System (MCS) 
if data communications activity is in process.The message text, after being stripped of the ‘““DC” characters and 
the following blank character, is transferred to the MCS input message queue and marked as “operator input’’. 


The interpretation of the message text is defined by the particular MCS. 


Format: 
DC | text 


Example: 


To enter the text “MAKE STATION 2 READY‘: 
DC MAKE STATION 2: READY 


Output messages: 


POSSIBLE CAUSES 


MCS input successful 


NC INVALIO no MCS in the mix 


DC NOSPACE There iS ro availabie 
message space in 
memory for this 
message 
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SUGGESTED ACTION 


check inputs execute 
the MCS 


wait a short time then 
ré"irput messaces if 
unsuccessful several 
times» request 
techrical assistance. 


DP (Discontinue and Dump) 


This intrinsic is similar to the “DS” intrinsic. The difference is that the disk work space (Virtual Memory 
on Disk, Virtual Disk) is not freed up and returned to an available status. 


The disk work space is, instead, updated from memory with all the most current information about the pro- 


for user programs, utilities, and MCP intrinsics). 
The peripherals and memory in use by the specified program are made available to other programs. 


DP is used when a technical analysis of a particular program is required following a failure during its 
operation. 


Format: DP mibcenumbeiy progrenrname 


Example: 


DP 01/GL060 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


imix number/program” DP successful none -« 
name DP‘ted 


input INVALIC mix nugber does rot Check tnput Creinput 
correspond to if necessary). 
Program name or 
Check with MX for 
proper mix numter and 
crogram name comtinat= 
ione 


input INVALIC - | program*name is Check with MX anc 
NEEDS PROGRA¥M=-ID) missing re"irpet. 
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DS (Discontinue Program) 


This intrinsic causes the orderly termination of the specified program. All peripherals in use by the program 
are made available to other programs. | 


Format: 


DS mix-number / program-name 


| Example: 


To terminate the program AR040 which has mix number 2: 
DS 02/AR040 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 
| mix/prog DSted DS successful 


input INVALID mix number does rot check with MX>» 
correspond to proar am reinput 
namesy or program is 
an MCS. 


input INVALIOD-NEEDS | program name not check with MX» 
PROGRAM I9 specified reinput 


Note: if the program is waiting on a “hung” peripheral device, try the CL intrinsic. 
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DT (Systems Date and Time) 


This intrinsic allows the operator to inquire about or change the system date and time maintained by the 


MCP. 
| NV one : @ mt fe 
Format: . 
DT | mm/dd/yy 
Examples: 


To inquire about the system date (and time if the system contains a real time clock) 
DT 


To change the system date: 
DT 01/01/78 


To change the system date and time: 
DT 03/23/78 1234 


“(March 23, 1978 is the new date. 12:34 is the time). 
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Output messages: | 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
"DOD MON YY YYODODD Normal response | rone 

HHMM DOW * to OT 

where 


DO = day of month 
MON = 3 letter 
abbreviatior of 
month. 

YY = year 

YYDO0 = Julian date 

HHMM = time Chours 
and minutes) 

DOW = day of week. 


INVALID DATE> An error was made Feingut date 
| in one of the follow” portion of 
ing fields: HeSSace 
MM 
DOD 
YY 
For examote = @ 
MM entry of "0" 
greater than 12 
is invalid. 
The entire date is 
rejected» tut a 
valid time entry 
in the same mess- 
age will be accept 
ed. 


|S INVALIO TIME> A time greater than Reingut time 

2359 was entered. portion of 
MESS ECE. 

The time iS rejected. 

A valic date entry In 

the Same messace will 

be accepted. 


Time entry was 
Maces but system 
has no realtime 
clock. 


Valic date entry 
wilt be accepted 
In Same message. 


MM/DD/YY HR=SMM Normal response 
to OT inquiry 
(B80C) 
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FD (Form Define) 


This intrinsic allows the operator to define a logical page for a serial printer (SPA) or set top of page for 
the SPA. 


Unless the operator indicates otherwise, the current position is taken as the top of the page. 


If the three parameters (HEIGHT, WIDTH, and OFFSET) are specified, then they are used to define a 
logical page on the SPA. HEIGHT specifies the number of lines on a logical page; WIDTH the maximum num- 
ber of characters in one line; and OFFSET the number of characters that the printing area is to be offset from 
the left. An OFFSET of zero specifies the left-most physical position. 


WIDTH and OFFSET added together must not be greater than the number of physical print positions on 
the serial printer. For example, if the physical printer has 255 columns the maximum printing area is given by 
a WIDTH of 255 and OFFSET of zero. The logical page will remain the same as defined by FD or next warm- 
Start. | ; 


FD SPA | height, width, offset 


Format: 


Example: 


FD SPA 66, 120, 5 


defines a logical page on SPA where height is 66 lines and the printing area is 120 characters wide offset 
5 columns from the left (that is; from columns 6 through 125, numbering the left-most column as column 


Output messages: 


MESSAGF POSSIBLE CAUSES SUGGESTEC ACTION 


FD SPA numbers FD specifications Check input ard re- 
INVALID for heichts» width» enter. 


and/or offset are 
not acceptable. 
Attempt to print 
heyond SPA capabil- 
ities. 


GO (Restart a Stopped Program) 


This intrinsic allows the operator to restart a program which has been stopped with the “ST” command. 


GO mix-number | / program-name 


Format: 


Examples: 


To restart program whose mix-number is 3: 
GO 3 


To restart program PRO20: 
GO 3/PR020 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


mix*number/prog@name specified program Check with MX for 
NOT STOPPED WwaS not waitinc suspenced prograr 
for a "GO" command. waiting for "GO" 
réinput. 


mix™number/prog=name BDotionat program Check with MX for 

INVALID name Was usec anc it correct mix number 
did not match the enc métching procrem 
mix number scecified. réewe. Reinput.e 
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MX (Display Current Mix) 


This intrinsic allows the operator to inquire about the status of any program(s) currently processing. 


MX | mix-number | / program-name 


Format: 


Examples: 


To inquire about all programs currently processing: 
MX 


To inquire about a particular program: 
MX 03/PR020 


or MX 03 
Output messages: 
MESSAGE | PROBABLE CAUSES SUGGESTED ACTION 
INVALID MIX Specified progran Check input Creineut 
is not currently if necessary). 
running. 
NULL MIX No programs are None. 
currently proc* 
esSS1nge 


Optional program Rerirput 
name was used anc 

1t did not metch 

the mix number 


specified. 


INVALID PROGRAM I0 


For each program specified, the following information is provided: 


MIX NUMBER 
a number assigned by MCP to this program as it was loaded into memory. 


PROGRAM NAME 
PROGRAM PRIORITY - “A”, “B”? or “C” 
a A = lowest priority (that is, application program) | 
B = medium priority (that is, system utility) 


C = highest priority (that is, data communications) 
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STATUS OF PROGRAM 
EXECUTING - program processing normally | 


SUSPENDED WAITED ON - program processing was temporarily halted. For reasons, see chart below. 


SHORT WAITED ON - program is waiting on a resource (that is, Virtual Memory or I/O buffer) which 
the system can guarantee will be made available in a relatively short time. 


SWAPPED OUT WAITED ON - portions of this previously suspended program were temporarily removed 
from real memory and returned to disk. Memory space was required for other programs in the mix. (Reasons 


for “swap outs” are same as for program suspension). — 


Possible messages are summarized by the chart below: 


mix / program 
number name 


Output message examples: 


C4/PFO60 A EXECUTING 


O4/PFO60 A SUSPENDED 


WAITED ON O/C 


O4/PFO60 A SUSPENDED 
WAITED ON VM 
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priority 


EXECUTING 

SHORT WAITED ON 

SUSPENDED 
WAITED OA 

SWAPPED QUT 
WAITED ON 


POSSIBLE CAUSES 


Program processing 
normally 


Pregram is waiting or 
a file open or close. 


Program is waiting 
on Virtual Memory. 


N/C 

VM 

SCL TASK 

CPERATCR INPUT 

ACCEPT 

Z1F 

I/C OR EVENT 

NC DISK FILE CNG FILED 


DUPLICATE FILE 


SYSMEM FILE 

NO USER DISK 
DIRECTCRY SPACE 
DEVICE (NO FILE) 
GC COMMAND 

EVENT TIMER 


SUGGESTEC ACTION 


None = program wilt 
te resumed when file 
tas bteen ocrenec or 
closed. 


None =: do not try to 
execute too many prog 
rams at this time. 
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| => at * PR 
) . y & 
LR ne BI 


&/PRO60 A SUSPENDED 
WAITED ON SCL TASK 


T10/ZLR B SUSPENDED 
WAITED ON OPERATCR 
TINPUT 


08/GL060 A SWAPPED 
{OUT WAITED CA ACCEFT 


OS/APO0Z0 A SUSPENDED 
WAITED ON ZIP 


O4/PRO69 A SEORT 
WAITED ON [/C 


1OS/PRO20 A SUSPENDED 
WAITED ON AO OISK 
FILE 


C2/7PRO20 A SUSPENDEC 
WAITED ON DUPLICATE 
FILE 


POSSIBLE CAUSES 


Progras is waitirg 
for a “command” from 
the MCP to be completed 
(such as response to an 
"OL™ trput). 


Program is waéitirg for 
some tinout from cpoeret™ 
ore (EX3 A program 
previously suspended 
by ST requires a G0 
commend to contirue). 


Program has disclayec 
an *ACPT™ message on 
SPO and is waiting for 
appropriate response. 


Program requestec 
assistance of anoth 
program itn order to 
complete this jokt. 
MCP will automatic” 
ally toad into memory 
the necessary prog” 
ram(s). 


Usually tncicative 
of normal process™ 
ings involving I/D 
activity te citsk or 


peripheral. 


Program needs (Card 
has not founc) a 
particular file tn 
order to Continue 
processing. 


Program is attempt> 
ing to place a file 
of a certain name 

on disk. However» 
another fite by the 
same name currently 
resides on disk. A 
disk may not contain 
2 files with the 


SUGGESTED ACTION 


None = program wilt 
te resumed when SCL 
task has completed. 


Provice program with 
ecprocriate input. 
Frogram will contirue 
processing. 


Refer to this program's 
operating instructions 
for suggested responses 
to ACPI. Then enter AX» 
mix number and select 
ed resfonse. 


None. 


KROoTe « 


Check SPO for message 


indicating name of file 
this program is seeking 
Then supply missing 
file (COPY fror 

bteckup medium or 

create it). If in 

coubt refer to 

cerogram instruct” 

TONS « 

Norméelty» remove 

the existing file 

from cisk with RM. 

If in coubt» refer 

to procram instreuct- 
TONS « 


ose ame aRC eo eee 
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MESSAGE 
10/COPY B SUSPENDEC 


WAITED ON DIRECTORY 
SPACE 


10/COPY B SUSPENDED 
WAITTED ON NO USER 
NISK 


10/LIST B SUSPENDEC 
WAITED ON SYSMEM 
Le 


O4/PRO060 A SUSPENDED 
WATTED ON NO FILE 
Beo 


Ba00. 


O4/PRO690 A SLUSPENDEL 
WAITED CN DEVICE 
2800 


O2/LR B SUSPENDED 
WAITED ON GO COMMNE 


POSSIBLE CAUSES 

When the disk was 
inittalizec the disk 
directory was constr” 
ucted to contain a 
fixed number of file 
namese The directory 
has now reackec 1ts 
Capacity. 


There 1S no more 
available space on 
disk* or space availt- 
able is insufficient 
to hoto the file the 
System 1S attenpting 
to writes or disk ts 
"checkertoarcec™. 


SYSMEM file cannot 
be tocatede 


Device that a croaran 
needs tn order to 
continue processing 
is either unévail™ 
able or not ready» 

or 


Program needs (Canc 
has not found) a 
particular file in 


order to continue 


processing. 


Device that a program 
needs in order to 
Continue processinc 
iS either unéveil= 
able or not reedy. 
Program was suspenc- 
ed by ST command. 


SUGGESTED ACTION 
Femove with RM any 
unnecessary files and 
crogram will continue; 
or DS the suspencec 
crogran. Replece 

cisk with another 

disk having sufficient 
cirectory soace» anc 
remexyecute the oroaran. 


with KA» analyze amourt 
cf available sface 
remaining. If disk is 
filled remove with FM 
ény unnecessary files; 
cr if cisk ts fillec 
and € dualt"oack file 

is desired» assign a 
cifferent cisk to this 
frogran (see AD intrin- 
sic)s cr if disk 15 
cteckerboardecs» use 

©@ utility to consol” 
idate disk space» then 
re"mexecute prcgrem 

that encountered 
SUSDENSTON- 


Reduest technical 
assistence. 


FY required cevice>s or 
éssicn proaram to atm 
ternaive device (see 
AT intrinsic). 


Check SPC for messéce 
indicating name of file 
crogran is seekirg. 
Supply missing file 
(COPY from backup wted- 
ium cr creeéete). 


RY required device; 
cr assign crocranr 

to alternate cevice 
(see AL intrinsic). 


Tyce "GO" clus mix 
number of suspendec 
crogr ci « 
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OL (Request for Status Information of Peripherals) 


This intrinsic allows the operator to request the status of peripherals on the system. 


OL | peripheral 


To display status of all system peripherals: 
OL 


Format: 


Examples: 


To display status of a particular peripheral: 


OL DKB 
OL LPA 
Output messages: 
MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
ceritpherat NOT Peripheral is rot Creck tnput Creinput 
READY on the systems if necessary) 
Peripherat may héve Ready peripheral 
been “Saved"™; if necessary. 


peripheral may not 
be correctly lcacec. 


OL oeripheral peripheral 15 not 
NOT CN SYSTEW configured on machine 


OL peripheral A nonwexistant device Creck input 
INVALID has teen specified Creirput if 
(that is» CL CCC) recessary). 


Other output messages produced by OL depend upon type of peripheral. Refer to the following examples 
for details. 


-Examples of disk device output: 


The general format of the output message is: 


SYS DISK number of 
disk-peripheral disk-name / NOT READY | files , FILES OPEN 
PO’D currently : 


in use 


Examples: 
DKA AR1/0 FILES OPEN 
DKB AR2/SYS DISK 2 FILES OPEN 
DMA PRA/NOT READY 0 FILES OPEN 
DKA AR1/PO’D 0 FILES OPEN 
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Examples of magnetic tape device output: 


The general format of the output message is: 


NOT READY 
multi-file name 
magnetic tape device filename 
UNLABELLED 
PURGED 


or 


multi-file name | J 
: : NOT READY 
magnetic tape device file name e : IN USE 06 


UNLABELLED SAVED 


eee BY Mmix-number / program-name 


Examples: 
CTA NOT READY 
CTA ARTAPE 
CTA ARTAPE/IN USE BY 10/TAPELR 
CTA ARTAPE/NOT READY IN USE BY 10/TAPELR 


Examples of output from any other device: 


The general format of the output message is: 


peripheral NOT READY 


ss 
peripheral fee _ | | { NOT READY } IN USE,.. 
UNLABELLED L SAVED 
ee «BY mix-number / program- name 
Examples: 


LPA.NOT READY | 

LPA NOT READY IN USE BY 04/PR020 
SSA SAVED 

SPA SAVED IN USE BY 06/PR060 
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PG (Purge Tape) 


This intrinsic allows the operator to purge (erase) magnetic tape and cassette tape files, thus labelling them 
as available for output. 


Format: 


PG __ tape or cassette peripheral 


Examples: 


To purge a cassette tape on drive CTA : 


PG CTA 
To purge a magnetic tape on drive MTC : 
PG MTC 
Output messages: 
MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
peripheral PG successful. Nore. 
* PURGED * 
PG INVALID peripheral not Fe-irput mess ece 
specified in messace- 
PG peripheral Tape could not be Make certain red tabs 
INVALID purged» as it 15 cn tcp of cassette are 


"write inhibited™» turned inwards make 
or peripheral is certéin “write permit 
not on the system. ring” is Inserted itr 


tape. Fetry FG. 


Note: if an attempt is made to purge a tape which is in use, then the response to the OL message for that 
peripheral is displayed. 
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PO (Power Off a disk) 


This intrinsic allows the operator to “logically” power off a disk (instruct the MCP that the disk is no longer 
required). At any time when the MCP is idle it is valid to logically power off the system disk with the PO 
command. This will cause the MCP to terminate. All systems disk files will be closed and SYS-SUPERUTL 
will go to End of Job (EOJ). 


No disk should be removed from the disk drive, no disk units should be powered down, nor should the main 


cabinet be switched off, until disks have been logically powered off with PO. Failure to observe this practice 
might cause disk problems at a later date. 


Format: 


PO disk peripheral 


Exampies: 


PO DKA (disk cartridge) 
PO DMB (mini disk) 
PO DFA (fixed disk) 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


disk peripheral OK Disk was legically It is row permissittle 
or powered off. to physically cower off 

disk peripheral enc remove the disk 

POWERED OFF from the disk arive. 


disk peripheral _ DIsk was physically Check cisk for possible 
REMOVED WITHOUT PO off Cefore being Corrupted data before 
logically power-=- re"useé. 
ec off. 


PO disk peripheral specified cisk Feincut. 
peripheral is 
nonexistant. 
(ex: PO DKW) 


Specifieo disk is Reinput. 
not currently on : 
line. 


CANNOT POWER OFF Attempt has been made Allow program to 
MIX NOT to PC the system disk co to Enc of Job 
while a pregram 15 (FOJ),» then reinput. 
processing. 
PO disk peripheral | 
(INVALID 


2015228 | 3—19 


If an attempt to Power Off a disk is made while files on that disk are in use, the OL message for the disk 
is printed. No further program will be allowed to open files on the disk and when all files in use have been 
closed, the disk will be logically powered off. If the disk is in use, it will not be powered off immediately after 
giving the PO command though it will print ‘disk peripheral PO’-ED X FILES OPEN”’, for all disks. 


If a disk is removed without being logically powered off, any program using files on that disk will eventually 
terminate with an error condition indicating hardware failure. 


A PO’d user disk may be made ready again by the RY command or by physically powering the unit off and 
on. 


PR (Assign Program Priority) 


This intrinsic allows the operator to alter the priority of a program by moving it to the highest priority position 
in the class specified. | 


Priority ““A”’ is low or normal priority, used for regular work. Within this class, programs which perform more 
physical I/O operations are given precedence. 


Priority ““B” is medium priority, used for utilities or programs which may be expected to do emergency work. 
The priority within this class is reverse historical: that is, a program of this priority placed in the mix will take 
precedence over previous programs of the same priority. 


Priority “C” is high priority, used for data communications programs that are transaction-driven. These are 
normally dormant, awaiting a transaction, but when required to process a transaction they take high priority 
to minimize response times. Within this class, programs which do more physical I/O are given precedence. 


Format: 


PR mix-number / program-name 


Ow > 


Example: 


To change the priority of mix-number 3 (program REPS506) to B: 
PR 03/REP506 B 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


mix=number/crogram- Input accepted 
name PR IS 
priority 


mix=number/program= Mixe-number and Check with “X for 
name PR INVALID program=name do propér Inout» end 
not match reenter 
or 
priority vatue 
incorrect 
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RY (Ready a Peripheral) 


This intrinsic is used to “ready” a peripheral so the MCP can use it as a resource. When warmstarting, the 
system will automatically ready all peripherals on the system that are powered on. RY may also be used to 
Ready a previousy PO’d user disk. 


Format: 


RY peripheral 


Examples: 


To ready a self-scan: 
RY SSA 


To ready a line printer: 
RY LPA 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


RY peripheral Attempt was mace to Check input Creinput 
INVALID Reedy a non"existant if necessary) 
peripheral (that is» 
RY LLP); 
Attempt was made to 
ready a device alreacy 
"ready". 


RY ceripheral NOT Attempt was mace to. Check input Creinput 
ON SYSTEM ready a peripheral if necessary). 
on-line to the 
computer. 
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SF (Substitute Disk File) 


This intrinsic allows the operator to direct a program to a particular disk file if it is waiting on a “NO FILE”, 
“NO PACK”, “DUPLICATE FILE”, or “BAD FILE NAME” condition. 


This command causes temporary modification of the program’s file parameter block. The modification remains 
in effect for the current execution only, or until it is remodified by the program during the current execution. 


The command can only be used when the program is suspended waiting on one of the above conditions. It 
is not possible to anticipate the program’s requirements and modify the file parameter block in advance. 


* k- 
SF mix-number | / program-name poe file-name 


file-name 


Format: 


Examples: 


Program AP10 (mix number 01) requests a disk file called APD2T on disk APD. To direct the program to 
use file APD2S on the same disk: 
01/AP10 <10> WAITING APD/APD2T DK NO FILE 
SF 01/AP10 APD2S 
(the first line is the MCP output message; the second is the input SF message in response to the “NO FILE” 
condition). | 
To direct the same program to use file APD2T on disk APD1: 
SF 01/AP10 APD1/ 


or 
SF 01 APD1/ 


To direct the same program to use file APTEMP on disk ARTD: 
| SF 01 ARTD/APTEMP 


Output message: 


POSSIBLE CAUSE SUGGESTED ACTION 


mix-rumber / Program is not Check with MX and 
program"name waiting on a “no re"menter. 
SF INVALID file” or other 

condition» or 

mix=number and 

prograrm“name 

do not correspond. 
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ST (Temporarily Suspend a Running Program) 


This intrinsic places a temporary halt on a program that is running. The program still appears in the mix. 
The data needed to restart the program exactly where it stopped is transferred from memory and stored on 
disk. The memory that was being used by the ‘“‘stopped” program is now made available to the MCP for other 
use. The GO command must be used to restart the program. 


ST mix-number | / program-name 


Format: 


Examples: 


To stop the program whose mix-number is 3: 
ST 3 


To stop the program PRO20: 
ST 3/PR020 


Output messages: 
MESSAGE © POSSIBLE CAUSES SUGGESTED ACTION 


mix"number/program ST success fut none 
name STOPPED 


mixe-number/program Program has already Check with MX for status 


name INVALIOC been stopped cf procrams Creinput if 
or necesséry)de 
proaram 1S not ir 
the mix. 
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SV (Save Peripheral) 


This intrinsic allows the operator to “logically” power off any input/output device (except disks, see PO intrin- 
Sic) in order to prevent their use by any program. 


“Tape peripherals” include magnetic tape (MT) and cassette tape (CT). 


‘Printer peripherals” include line printer (LP) and serial printer (SP). 


Format: 
tape peripheral 
printer peripheral 
SV self-scan peripheral 
card-reader peripheral 
card-punch peripheral 
Examples 
SV LPA 


SV SSA 


It is possible to “save” a device that is being used by a program. This will allow the program presently as- 
signed to this device to continue using it, but will prevent any subsequent programs from using the device. For 
example: 


SV LPA 
LPA SAVED IN USE BY 06/PR060 


A “saved” device may be made “ready” again with the RY command or by physically powering the unit off 
and on. 3 | 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 
pertpheral OK SV successful 


SV peripheral Attempt was made to Feingput Cif necessary 
INVALID Save a disk perip- LSinc correct pericm 
heral Feral. 
or 
device has already 
been saved. 


SV peripheral Specified cperipherat  §§$Check input’ reinput 
NOT GN SYSTEM is not onwtlire te If necessary. 
the computer. 


pertipherat POWER-@ SV successful. 
ED OFF 
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VE (Vertical Format on Printer) 


This command allows the operator to define the actions to be taken by the printer when certain vertical for- 
mat commands are sent. This command applies only to printers which have soft vertical format control. 


Format: 


VF peripheral height ,line number Sumber number 


The height field specifies the page height in lines. The channel number and line number fields are optional 


but when specified they must both be present as a pair. The channel number should be 2-11 and page height 
should not be more than 94. 


Example: 


VF LPA 66, 60, 2 10 


where page height = 66 
end of page = 60 
channel number = 2 
line number = 10 


NOTE: For details see LOAD.VFU utility. 


Output Messages: © 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
VFU LOAD FAIL =« | Typing error correct the input 
ILLEGAL PARAMETER and rewenter 

IST | 

FU LOAD FAIL - The speci fied RY the peripheral 
peripheral NoT peripheral is not and re-enter 
ON LINE ready 
VFU LOAD FAIL - The speci fied Wait until program 
o9eripheral 3 peripheral is has closed the printe 
IN USE in use by a program file» then reinput 
IWFU LOAD FAIL = The peripheral is” None 
peripheral HAS not a B9249~=30/50 


INO SOFT VFu Line printer 
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SECTION 4 
CMS-COMMON UTILITIES 


INTRODUCTION 


This section describes all standard CMS utilities that form part of a CMS system software release. The applica- 
bility of any utility depends on the type of hardware available. For example, utilities requiring.console_files_can- 
not be executed on machines without.a. console: as an “example, CREATE, AMEND and UPDATE cannot be > 
fun on a B 1800. 


Table 4-1 gives a list of all required peripherals for each utility. In this table, required peripherals are denoted 
_ by the letter “R”, and optional peripherals by the letter ‘“‘O’”’. One asterisk (“x ?) indicates that out of all the 
options, at least one is required. In particular, those utilities requiring a line printer may use a console printer 
by default if the line printer is not present on the system. Two asterisks (“‘es’’) indicate that out of all the op- 
tions, at least two are required. 


All the utilities that use initiating message information provide al “star-file”! facility. This permits the informa- 
tion to be provided in a disk file instead of from operator SPO input. The entire message, after the name of 
the utility, may be replaced by an asterisk followed by the disk file name. The format is 


i | disk-name / file-name 


the input could be 
RM * M101A/RMFILE 


where RMFILE is a disk file on disk M101A containing one record with the contents 
REP200, REP562, RQ=, RCOPY 


For_all_utilities except the compile utility (CO, see_s section 6), star-files may contain a_ maximum of five | 
records, and the record-size must be 80 characters. The information should be padded to the bad of each record ( 
with spaces. No nésted star-files are allowed: that is, the information _in_asta ma ontain_a_call_on / 
another _star-file. If the specified file cannot be found, a “file-name NOT FOUND” message 1S vaisplayed Dy } 


the utility. 


SYS-SUPERUTL 


This system utility provides the following functions: 
CH - change the name of a file or group of files 
| KX — interrogate disk space 
hae — interrogate disk directory 
RM -— remove a file or group of files 
\ GR — initiate recall of SPO log messages 
— look back in SPO log 


re LF - look forward in SPO log 
It will execute automatically if the program file is on the systems disk when one of these functions are re- 
quired. This program is also automatically executed at warmstart time and co-ordinates logging functions at that 
time. 
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The utility has some features which can cause the operator confusion. The utility will not appear in the re- 
sponse to the MX command unless it is actually performing one of its functions, when it will appear as 12/ 
PD or 12/CH etc., according to the function which it is currently performing. If an attempt is made to execute 
one of the SYS-SUPERUTL functions when it is already busy then a response of “<64> LOAD FAILURE 
UTILITY BUSY” will be returned. | 


Table 4-1. Peripherals Required By CMS-Common Utilities 


paper 
punch |tape IC MD 


R 
R 
R 
R 
R 
R 
R 
F 
R 
R 
R 
R 
R 
0 
R 
R 
R 
R 
R 
R 
R 


When the system is warmstarted the SYS-SUPERUTL utility will be initiated and SYS-LOG files will be cre- 
ated. The information about the number and size of log-files is stored in a file called “SYSCONFIG” (see CON- 
FIGURER). Then the MCP will initiate a function of SYS-SUPERUTL, which will start up the ‘TL’ utility, 
and the transfer of log-files to a ‘““SSYS-LOG-HOLD” file will begin. When all the log-files are transferred and 
TL goes to End of Job, SYS-SUPERUTL will remove the old SYS-LOG files and create new SYS-LOG files. 


During a session all the console input/output messages that normally appear on the SPO are stored in SYS- 
LOG files SYS-LOG-01 through SYS-LOG-nn, where “‘nn”’ is 03 to 16 (see CONFIGURER). When one log- 
file is full the messages will be directed to the next log-file. When all the log-files are full the logging will be 
directed to the first file again. This will overwrite the information held in the SYS-LOG-01 file unless the utility 
““TL” is begun beforehand, which will transfer all the transferable) log-files and keep them in the ‘““TRANS- 
FERRED” state (see TL and WL). 


The system will automatically transfer all log-files only at warmstart time. 


COMMON UTILITY OUTPUT MESSAGES: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


INVALID CHARACTER Nisk name or file nane Check input ard 
IN IDENTIFIER contains character(s) re-input if nec@ 
not permitted by the essary. 


Systeme Valic charac” 
ters are: AwZ» O79» 
. (dot)» - (dash). 


ILLEGAL PARAMETER Typing error. Check input. After 
LIST | words “ILLEGAL 
| PARAMETERS LIST” 
system will display 
portion of input 
message that contatns 
error.e 


filetname NOT FOUND Specified file name Check input and reenter 


or is not on disk. if necessary, check 

filename NOT ON for Correct Cisk; 

LINE | supply specified file 
(COPY file from back~ 
up meéecium or create 

See file). a 

NO SPECIFICATIONS Input message 1S Check input and 

GIVEN incomplete. reenter e 

DISK disk"name Specified cisk is Check input ard 

NOT GPENED NOT ON not online to rementer if necessary: 

LINE computer. Check for correct disks 

ras Ready Cisk; 


IDISK disk=-name 
NOT AVAILABLE 


AVAILABLE 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


FILE LIST MAY BE A group of files on an 

INCOMPLETE unrestricted pseudo 
disk was requested» but 

the disk 1s off-line. 


PSEUDO@DISK pseudo The pseudo disk 
disk=name ON DSK specified has not been 
disk=name NOT founde 

AVAILABLE 


DISK diskename IS The disk specified is Correct the disk 
A PSEUDO"DISK not a physical disk name and reinpute 
but a pseudo disk: 

protably the input 

cisk name is incorrect. 

This message ts printed 

by. those utilities 

which cannot handle 

pseudowdiskse 


ADD (Add Files From Library Tape to Disk) 


This function, a part of the utility LD, allows the operator to copy files from a library tape to a disk. 


Format: 


| LD | ADD FROM library-tape-name | TO disk-name | 
file-name or | y 
group-name |< BOTH>- _ 


If the <BOTH> option is used immediately after a request to add a keyfile, the data file will also be copied, 
provided it does not precede the keyfile on the library tape. The keyfile will then refer to the disk which now 
holds the data file (rather than the disk from which the data file was dumped to the library tape). 


A file is copied only if no other files on the specified disk have the same name. 


Examples: 


To copy all files from ARTAPE to the system disk: 
ADD FROM ARTAPE= 


To copy a file called PRFILE from PRTAPE to a disk called PRBU: 
ADD FROM PRTAPE TO PRBU PRFILE 


To copy files called GL300 and GL200 from GLTAPE to the system disk: 
LD ADD FROM GLTAPE GL300 GL200 


To copy a keyfile called PR240K and its data file from a tape called PRTAPE to a system disk= 
ADD FROM PRTAPE PR240K <BOTH> 


Since “ADD” is a part of the utility LD, ““LD” is actually what will appear in a mix message. To discontinue 
the ADD function, “DS mix- number/LD” must be used. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


filename LOADED ADO successful 


iLibrary"tape"name Specified tape does Frovide correct tare 
NOT A RECOGNIZED not have a valid CMS énd retrys or OS LO 
DUMP TAPE Labels» or has not ctility. 

been created by the 

tp utility Cfor 

example? tape 15 a 

COPY tape). 


NO FILES IN THE | Specified group was Check input and re- 
FAMILY group"name not found con library input if necessary? 

1ON TAPE Library- tape. | Check for correct 

tape-name FOR libraryctape. 

ADD 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


INO FILE filename Specified file was not Check input and revinput 
ON TAPE Library-tape- found on tibrary if necessarys check 
iIname FOR ADC - tape- for correct Library 
tape. 


|filetname LOAD/ End of File reached Try tépe on different 
DUMP DISCREPANCY before expectec. Disk crive in case the 
Fite Header may te crive is at fault. 
corrupted. Possifly 
due to miS*reacding 
of tape. 


NO FILES TO LOAD files were found Input and re 
this tape to cony 1f necessary, 
disk. for correct tape. 


Ilfiltetname NOT LOADED File not copied as a Normatly remove with 
Im ALREADY ON OISK. file with the same kM the duplicate file 
ALTHOUGH WITH name already exists and re-attempt the 
DIFFERENT ATTRI8=~ on disk.» If the Z ADO. 
UTES. files aiffer in records 

blocks» and file sizes» 

the "DIFFERENT ATTRIa- 

UTES" message prints. 


file-name DATA FILE Nata file for given 

NOT FOUND ON TAPE keyfile does not 

FOR LOAD. | follow on tape. Data 
file cannot be copied. 
Keyfile is Copiec. 


Note: Refer to “Common Utility Output Messages” for additional aid. 
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AMEND (Disk File Amending) 


This utility is used to modify records within an existing data on source file. The “CREATE” and “UPDATE” 


utilities use many similar features. 
a | 
! nN 


AMEND | disk-name / 
Input may be either alphanumeric (A) or hexadecimal (N). (See “CREATE” for details). The default is “A? 


Format: 


yw | 


number 


file-name 


The “number” option may be used to set ‘tab’ positions for character input (see “CREATE” for details). 


The nan operates in two modes: “Record Modify” (PK2) and “Record Select” (PK3). 


PK1 is used to select the next sequential record in the file to be printed. The use of PK1 terminates “Record 
Modify” and “Record Select” modes, therefore a re-selection of mode must be made before continuing. 


If PK3 (Record Select mode) is used, the required record is identified by logical record number using this 
- format: 
| RECORD number 


The “number” may take any value from 1 to the number of records in the file. 


PK2 is used to make corrections to existing records. This PK operates as PK2 in CREATE utility (see CRE- 
ATE for details). | 


Example: 


To amend a source file called MYFILE, record size 40 bytes, tab set at 5, 10, 15, 20: 
- AMEND MYFILE 5 10 15 20 


First select a record by pressing PK3, and then enter “20” for logical record 20 in MYFILE. Utility selects — 
and prints the contents of record 20. 


20 ABCDEFGHIJKLMNOPORST | 


To replace characters, press PK2 and type the replacement 
D : ZZZZ : OCK1 | 


resulting in “20 ABCDZZZZIJKLMNOPORST” 
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Or if insertion of characters is desired, type the characters to be inserted into the record: 
Z: XXXXXXK : OCK2 


resulting in “20 ABCDZXXXXXXZZZOPORST” 

NOTE: the insertion from character six to eleven will result in the shifting of characters “ZZZIJKLMN” from 
byte position 12 to the boundary of the next tab position, which is 15. Therefore only 3 characters “ZZZ”’ are 
shifted from 12 to 14 and “IJKLMN” are lost. The text from the next tab position 15 onwards is not affected. 


Output messages: 


Refer to the section on the “CREATE” utility for output messages. 
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CH (Change File Name) 
(a function of SYS-SUPERUTL) 


This utility allows the operator to change the name of a file or group of files on disk. The <DATA> option 
allows the data file of an indexed pair to be changed, and it will also cause the keyfile to refer to the new 
data file name (the keyfile name does not change). 


Format: 
file-name or | | file-name or 
CH | disk-name / group-name <DATA> TO group-name 
Examples: 


To change the name of a single file: 
CH BPS320D/DCSTSK36K TO DCSTSK 
CH DCSTSK TO INDISK3TSK 


To change a group of files: 
CH BPS320A/AR= TO BP= 
CH PRB= TO PR= 


To change several different files or groups of files: 
CH DCSTSK TO INDISK3TSK, BPS320A/AR= TO BP= 


To change the name of the data file of an indexed pair: 
CH AR200K <DATA> TO AR200BU 
Note: if a change of group file name is specified with the <DATA> option then the data file should appear 
in the directory after the keyfile. If this is not the case then the name of the data file is changed first, and 
when the attempt to change the key file name is made, a ‘“‘data filename NOT FOUND” message will be dis- 
played. This will not occur when changing the name of a single indexed file. 


Output messages: 


MESSAGE POSST@LE CAUSES SUGGESTED AC TION 


"fite name” CHANGED TO Fite name success None. 
"file name” fully changed. 


"file name” NOT Specified file Check input or (Cres 
CHANGED = NOT FOUND name 1s not on input 1f necéssary) » 
disk. Check for correct 
—Cisk.e 


NO FILES FOUND FOR Specified group Check input Cre~input 

CHANGING IN THE name 1S not on  3f necesSary) 

FAMILY. “group name" disk. Check for Correct 
cisk. 
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MESSAGE 


“fite name” NOT 
CHANGED IN USE 


"name™ FILE IDENT" 
IFIEF TOO LONG 


"file name™* NOT 
CHANGED = ILLEGAL 
REQUEST 


"file name” NOT 
CHANGED = "file nare” 
ALREADY ON DISK 


KEYFILE “file name" 
NOW POINTS TO DATA 
FILE “file name”. 


<64> LOAD FAILURE 
UTILITY BUSY 
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POSSIBLE CAUSES 


Fite's name Cannot 
be changed because 
it 1s currently 


being used by system. 


Attempt has been made 
to change a file name 
to more than 12 

characters in leroth. 


Attempt has been made 
to change the name of 
a file to “SYSMEM” 

Ca name reserved for 
system use) or att 
Spaces. 


Attempt has been made 
to duplicate the name 
of a fite atready on 
disk. 


Successful comptletior 
of data file name 
change. 


Another function of 
SYS“SUPERUTL 1s being 
executed. 


SUGGESTED ACTION 


halt untit file is 


ro toncer 


in use » 


then reé“input. 


Retinpute 


Re=irput. 


Re-irput. 


Wait until 
SYS*SUPERUTL is 


frees 


then re~ingut. 


CHECKADUMP (Compare Library Tape with Disk) 


This utility allows the operator to compare information in files on a library tape with corresponding files on 
disk. It is used to verify that a library tape is correct after files have been DUMPed or !|'UNLOADed, or that 
disk files are correct after files have been ADDed or LOADed. Specified tape is processed sequentially, file 
by file, and the disk is searched for corresponding files. The utility will notify the operator on up to four errors 


in a given file. If there are more than four errors, it will ignore the rest of that file, and proceed to the next 
file on tape. | 


Format: 
CHECKADUMP library-tape-name | WITH disk-name 


Examples: 


To compare files on the tape called PRTAPE with the corresponding files on the system disk: 
CHECKADUMP PRTAPE 


To compare files on the tape called ARTAPE with the corresponding files on a disk called ARDISK2: 
CHECKADUMP ARTAPE WITH ARDISK2 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


Library-tape-name First record of tape None. Utility ends. 
NOT A RECOGNIZED not recognized by 
DUMP TAPE CHECKADUMP. Tape 

may not have been 

created by LD 

utility. 


Library-tape-name More or fewer entries None. (See CMS MCP 
INVALID DIRECTORY in directory on tape Reference “anual 
ON TAPE than specified ir the for adcitional in- 
first record of tape. formation on tabde 
| formats. 


4 


COMPARISON ERROR Header in tody of tape fecreate dump tape. 
JON Library-tape- 1S not identical to | 
name ON OISK FILE respective header in 
HEADERS. disk directory. The 
| error count for the 
file is increased by i- 


COMPARISON ERROR Corresponding cisk 


ON filename FILE NOT file cannot be found 
FOUND FOR CHECK. for fite on tafe. 


Recreate dump tape. 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


COMPARISON ERROR ON Corresponding aisk 
filename FILE NOT file cannot be read 
AVAILABLE FOR for this file on 
CHECK tape. 


Recreate dump tape. 


COMPARISON ERROR ON Discrepancy between 

filename CAROUND disk file and tape 

RECORD number) file. Record numter 
In vacinity of error 
in file is printec>, 
if possible. One is 
added to error Count 
for this file. 


Recreate 


COMPARISON ERROR ON Difference in length Recreate 
filename AROUND of tape and disk files. 

END OF FILE One 18 added to error 

count for that file. 


COMPARISON ERROR Difference in sizes Recreate 
ON filename DIFFER- of disk and tape 
ING FILE SIZES files. 


COMPARISON ERROR ON Difference in file Recreate 
file"name CIFFERING types of files being 
FILE TYPES como ared. 


COMPARISON ERROR ON Difference in recorc Recreate 
file-name DIFFERING sizes of the files 

RECORD STIZES being comoared-. 

COMPARISON ERROR ON Difference itn block Recreate 
filename CIFFERING sizes of files being 

BLOCK SIZES compared. 


NO DISCREPANCIES CHECKADUMP success” 
BETWEEN DUMP TAPE ful. 
library"tape"name 

AND DISK disSk-name. 


DISCREPANCIES FOUNC Discrepancy discover” Recreate 
BETWEEN DUMP TAPE ed between disk file 
Library"tape“name and tape file. 

AND DISK disk-name. 


NOTE: Refer to “Common Utility Output Messages” for additional messages. 
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CHECK.DISK (Check all Sectors of a Disk) 


This utility reads every sector on a specified disk, and reports on any parity errors encountered. 


Format: 


CHECK.DISK | disk-name 


If no disk is specified, the system disk will be checked. 
Example: — 


To read and report any parity errors from sectors of a disk ARBK: 
CHECK.DISK ARBK 


If If the fee that it is being tun ont megabyte HORRY disk, It will give an additional message at_end 
of job if circumstances 2s dictate, _as follows: ““-"oc- a 


RAE Raa ee umieenacrrs maap TNE 


See are found then the following message is displayed: 
DISK disk-name SHOULD BE REINITIALISED SOON 


If more than 31 bad sectors are found then the following message is displayed: 
| DISK disk-name EXCEEDS BAD SECTOR LIMIT 
PLEASE POWER OFF DISK disk-name 


If this message is given, then the disk should not be used again. 


Output messages: | 
MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
CHECK .DISK ON disks This message is 


nane COMPLETED - ONE displayed after all 
ERROR NOTIFICD. sectors have been read 


and one error has been 


detected. 


CHECK e-DISK ON disk- The utitity has found 
name COMPLETED - more than one bac 
number ERRORS NOTIFIED sector. 


READ FRROR ON OCL OF An error was None. 
disk=namee encountered while. 

reading sector zero of 

the specifiec cisk. 


ERROR NOTIFIED ON Normal output messagee None. 
READING SECTOR n Utility continues. 


CHECK-DISK ON Normal EUJ messageSe 
disk=name COMPLETED 
“ERRORS NOTIFIED 


or 


CHECK -DISK ON 
disk=name COMPLET=-_ 
JED-NO ERROR 


Note: refer to “Common Utility Output Messages” for.additional messages. 
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COMPARE (Compare Files) 


This utility compares corresponding records in two files, or in pairs of files within two groups. A realignment 
feature is also available as an aid to detecting missing records. 


Format: 


| | | file-name or 
COMPARE disk-name / group-name WITH 
file-name or | 
disk-name / group-name | R 


To compare file PQ60R on the system disk with file PQ60RS on disk PRB3: 
COMPARE PQ60R WITH PRB3/PQ60RS 


Examples: 


To compare the groups of files beginning with AR and the files A27Q on disk ARBK1 and ARBK2: 
COMPARE ARBK1/AR= WITH ARBK2/AR=, 


ARBK1/A27Q WITH ARBK2/A27Q 


To compare the file [V20F on the system disk with the file of the same name on disk I32, with realignment: 
COMPARE IV20F WITH [32/IV20F R 


If corresponding records are different, the following is printed on a line printer file (or console printer if the 
line printer is not available). 
DIFFERENCE DETECTED AT BYTE @nnnn@ 
where n is the number of the byte in the record, starting from 0. The two records are then printed, using 
more than one line if necessary,with the following format: 
byte-offset 
32-byte groups in hexadecimal 
32-byte groups in ASCII 


(A null character (00) in hex is represented by “..’’, and a non-printable character in ASCII represented by 
a ca ees . Rae HSE LHS SRO SLA EUS NTE tease euneisneesvnzcees HOSS ORE PHERU ap secs useeacenePenseicestetchen nen OTE NCCC AACN RUM EERO Sanaa eae 
a blank). aoe ae rns 


tea, 


Comparison of groups of files works as in the following example: 
Assume DISK1 contains the files A, B, C, D, AB, AC, ABC, BC. 
Assume DISK2 contains the files A, B, C, D, AB, AC, ABC, BC, BD, EF. 


Then 


COMPARE DISK1/= WITH DISK2/ = compares all files on DISK1 with the corresponding files on 
DISK2. 


But 


COMPARE DISK2/= WITH DISK1/= compares files on DISK2 with the corresponding files on 
_DISK1, and will fail to find DISK1/BD and DISK1/EF. 


- Similarly, 


COMPARE DISK1/A= WITH DISK2/A= compares files A, AB, AC and ABC on DISKI1 with the 
corresponding files A, AB, AC and ABC on DISK1 with the corresponding files on DISK2. 
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Also, 
COMPARE DISK1/A= WITH DISK2/AB= compares the following pair of files: 
DISK1/A with DISK2/AB, 
DISK1/AB with DISK2/ABB, (not found) 
DISK1/AC with DISK2/ABC, 
DISK1/ABC with DISK2/ABBC (not found) 


nment 


The reali 


option works in following 


i { een tricone Oe eset 
“7 all Sony 


It_three_consecutive records fail to compare then. an attempt.is.made.to.compare the third record _of the second 
file_with.the..next-two—records of the first_file.... 


PR ERED RRNA T RETO 


{ 
If all these five comparisons fail then an attempt is made to compare the fifth record of the first file with 
the fourth, fifth, sixth and seventh records from the second file. 


If this comparison fails, then the comparison is terminated with an appropriate message (see later). )) 


If a correct comparison occurs at any stage, then the compared records are used as synchronization for restart- 
ing normal comparisons. 


For example, consider FILE1 see 10 records A, B, C, D, E, F, G, H, I and J, and FILE2 containing 
twelve records K, L, M, N, O, P, Q, R, S, T, U, and V. 


The utility compares record A with record K, then B with L, then C with M. If all these comparisons fail, / 
then if realignment is specified record M is compared with records D and E. If this also fails, record E is com- | 
pared with records N, O, P and Q. If none of these compare, the comparison is terminated. et 


Note that if there is a missing record in one file, and realignment is NOT specified, a comparison error will 
arise on every succeeding record until end-of-job. 


Additional Capabilities 


Further features in this utility are summarized in the railroad chart given in Figure 4-1, which gives the com- 
plete input specifications. 


Non-disk devices: 


Files on devices other than disk may be compared by following the file name by one of the following key- 
words: 


CRD -—- any 80-column or 96-column card device 

PTR — any paper tape input device 

MTP — any magnetic tape or cassette device 

DSK — any disk device (the default; this keyword is for 
documentation only) 
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Co mrs oa, 
ff 
é 


— COMPARE 


< comp-spec > 


* L < disk-id >/ Vv < file-id > 


< comp-spec > is defined as : 
< mfid-spec-1 >— WITH — < mfid-spec-2 > 


<gid-spec-1 >— WITH — < gid-spec-2 > 


< mfid-spec> is defined as : 


CRD 

MTP : : | EY-number-number 
——< mfid >-/—< file-id > <nr>4< nb> 

PTP 1 RECORDS-number-number 

DSK 1 EBCDIC 


< gid-spec> is defined as : 


< disk-id > —/— .< group-id> —-DSK = < nr < nb> 


Figure 4—1. Railroad Chart for Compare Utility 


Examples: 


To compare records on a cassette file ARDUMP/FILE020 with a file AR578QQ on the disk WDSK: 
COMPARE ARDUMP/FILE020 MTP WITH WDSK/ARS78QQ 


(note that the two-part name is valid for multi-file tapes or cassettes, refer to section 2 for naming conven- 
tions). 


To compare two card files DAT1 and DAT2: 
COMPARE DAT1 CRD WITH DAT2 CRD 


Record and block sizes: 


The record size (and the number of records per_bloc 
a One 


wore if applicable | "i 
\ bs 
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Examples: 


To compare a system disk file CU265 with a magnetic tape file TPF, treating die blocks on the tape as 80- 
byte records blocked 9 records to a block: 


COMPARE CU265 DSK WITH TPF MTP 809 ? 


COMPARE SCRO1 WITH SCRO2 902 | a 


Note that if the records to be compared are of different lengths, and reblocking is not sectilicd: then only / // 
the number of characters in the shorter record are compared. 


If EBCDI used the file will be translated from EBCDIC on input. The option KEY allows the comparison 
to be done only on the field acinet the remainder of each record will be ignored. The first number is the 
offset of the field within the record, the second is its length. If two files have keys of different lengths, the _ 
shorter length will be assumed for both the files. 


sore ATA AO 


Examples 


Compare fields starting at_byte 11 for 4 characters of FILE] with FILE2. 
COMPARE FILE1 KEY 10- 4 10-4 WITH FILE2 KEY 10- 4 


The_option RECORDS. allows..the..comparison..to.be done only on the records specified. The first number 


is the starting record number and the second number is the total number of records available for comparison. 
No other _record..will be read from.that file. 


Example: 


Compare records 12, 13, 14 of FILE1 with records 10, 11, 12 of FILE2. 
COMPARE FILE1 RECORDS 12 a ae FILE2 RECORDS 10 3 


‘ ; a ee 
\ tt f al 6 Cs <A, 


a a = 
Re cl te oes os rn ee g 


Limitations: 
Y———ennantinentn coverage 
The maximum record size is 1024 bytes. Ifa file. exceeds this record size, it may be compared by reblocking. — ; 
For example, a file with record size of 1200 can be compared by reblocking as 600 bytes blocked 2, or as 300 
bytes blocked 4. The higher the blocking factor, the slower will be the comparison. (If the record size is a prime 
number P, it can be reblocked as 1-byte records blocked P). 


“Ssrommenrnaynanactsorantimnnsr-nerr qe 


The use of a star-file terminates the list of pairs of files to be compared. For example, 
COMPARE A= WITH DK2/A=, X= WITH DK2/X=, 
STFILE, B= WITH DK2/B= 


will compare A=, X= and all files mentioned in the file STFILE, but will ignore the comparisons of B=. 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 
END OF FILE filename End of one file is None. 
BEFORE filename =~ detected before the 


n ERRORS end of the other file 
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MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


f,tename WITH Normal ending message None. 

filename COMPARED - if both fites ére 

n ERRORS Same S1Ze. 

ILLEGAL SYNTAX Initial Input wiss Check input ard 
FOR ITEM input typed. re"ernter. 


CANNOT REALIECN Ending mesSaqae if 
filename WITh realiaqnment has teen 
filename"n ERRORS specified but has 

failed. 


INCOMPATIBLE : A file is specified Retinput Correct 
FILESPECS input to be compared with meSSéae€. 

a groucv of files» or 

vice versa. 


Input message greater Divice input into 
than 256 characters. separate parts» anc 
rermerter. 


ITEM TOO LONG input 


DIFFERENCE DETECTED See example earlier See exemple earttier. 
AT BYTE annnn@ 

CANNOT READ RECORD Parity error on Use tackup cory cf 

n OF filename disk fite. file ccencernec»s if 


possible. 


ILLEGAL KEY FOR fite- A key has been Check the key length 
nawe:s number number specified with a length and re~input if 

zero or which does not necessary. 

ite completely within 

the record. The 

utility will proceed 

with next item. 


ILLEGAL RECORDS FOR The record number None. 
filenames number specified for the 

starting point of 

comparisons 1s not 

present in the file. 


CANNOT COMPARE PAST The utitity Limitation None. 
POSITION numoer IN came into effect due 
filename to a request te compare 
beyond an offset of 
number bytese 


filename EXHAUSTED The file had a record Nonee 
AT number range specifiec which 

ran beyond the end of 

file. The range has 
teen truncated. 
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COPY (File Copy) 


This utility allows the operator to copy files from one medium to another. 


Format: 


| file-name or 
COPY disk-name / group-name 


< KEY > 
or 
<BOTH> 


TO 


file-name or 
disk-name / group-name 


If as a result of the copying a file a duplicate filename would be created, the original file on the destination 
disk is removed automatically. 


If the file being copied is a keyfile and the <KEY> option is used, the keyfile is copied and the new keyfile 
refers to the original data file. 


If the file being copied is a keyfile and the <BOTH> option is used, the keyfile and the corresponding data 
file are copied. The data file is given the keyfile name with the letters, ““QQ”’ appended. The new keyfile is 
made to refer to the new data file name. 


If the file being copied is a keyfile and neither <KEY> nor <BOTH®> options are used, only the correspond- 
ing data file is copied. The records of the new data file are created in keyfile order. 


Examples: 


To copy a file called AR200 from the system disk to a disk called ARBU: 
COPY AR200 TO ARBU/AR200 


To copy files called AR200 and AR300 from the system disk to a disk called ARBU: 
COPY AR200 TO ARBU/AR200 AR300 TO ARBU/AR300. 


To copy a file called APTASK from the system disk to APBU, changing its name to APTASKB: 
COPY APTASK TO APBU/APTASKB. 


To copy all files beginning with letters “PR” from disk PR2 TO disk called PRBU: 
COPY PR2/PR= TO PRBU/PR= 


Copying Keyfiles 


Assume there is a keyfile called PR200K which refers to a data file called PR200. 


The statement | 
COPY PR200 <KEY> TO PRB/PR200K will create a new keyfile PR200K on disk called PRB which 
references the original data file, PR200, on the system disk. 

The statement 


COPY PR200K <BOTH> TO PRB/PR200K will create a new keyfile and data file on disk called 
PRB. The name of the new data file will be PRB/PR200KQO and the keyfile (PRB/PR200K) will refer 
to this new data file. 

_ The statement 


COPY PR200K TO PRB/PR200K will create a new datafile PR200K on the disk PRB. No new keyfile 
will be created but the records in the new data file will be created in key order according to the keyfile. 
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Additional Capabilities 


Further features in this utility are summarized in the railroad chart given in Figure 4-2, which gives the com- 
plete input specifications. 


* < file-name > 


< group-copy > 


< d-file > 


TO 


<s-file > 


< group-copy > is defined as : 


—aw < group-name-1> TO —— < group-name-2> —> 


<s-file > is defined as : 


CRD 
1 MTP 
PTP 
< BOTH > 
1 
< KEY > < r-spec > 
—< file-name 
1 RECORD < n> 
1 LL TAPEMARKS —— <nt> 
1 NO.LABEL 
1 EBCDIC 


Figure 4—2. Railroad Chart for Copy Utility (Sheet 1 of 2) 
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<d-file > is defined as: 


1 RECORD 


PEELS EEL TERE EPID E LE AR 
ac ven 


<nr 


eee NET 


jon eA ARSE AON SHES 
pisses se PONG oe nine 
Frere ™ Dial e Mayctoaraney 


eer 


1 FILESIZE omnes} f > 


ane 
gee ms 


1 SINGLEAREA 
1 CRUNCH 


1 EXTENDING 


Trace NPR EAT ARENT LL SCREAMER CATERED DONUT ERS IE 


1 EBCDIC 


< file-name > 


CRD 


1 MTP 


PTP 


< r-spec> is defined as : 


< r-count > 


< record-key > 


/ = <record-key > 


Figure 4—2. Railroad Chart for Copy Utility (Sheet 2 of 2) 
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Non-disk devices — 


Files may be copied to and from media other than disks. Abbreviation for the valid devices are as follows: 
MTP — magnetic tape or cassette 
CRD — punched card 
PTP — paper tape 


Examples: 


To copy a cardfile called PRFILE to a disk called PRBU: 
COPY PRFILE CRD TO PRBU/PRFILE 


To copy a disk file called PR300 to a single-file magnetic tape: 
COPY PR300 TO PRTAPE MTP 
NOTE 
This tape is in ““COPY” tape format, not “LOAD/DUMP” format. To access this 


tape file again it will have to be placed on appropriate device by “COPY” utility, 
not °’ LOAD/DUMP”’. 


To copy a cardfile called PRFILE to paper tape: 
COPY PRFILE CRD TO PTFILE PTP 


Note: Paper tapes are always “unlabelled’’, and when accessing it, MCP will issue appropriate message requir- 
ing an “AD” intrinsic response from operator. See “‘AD”’ intrinsic. 


Unlabelled tapes 
Input tapes having no CMS labels (“unlabelled”’ tapes) may be accessed by the COPY utility. 


The NO.LABEL option allows the copying of unlabelled files. Upon recognizing an unlabelled file, the MCP 
will print a “DEVICE REQUIRED” message. The operator must then respond with an appropriate “AD” in- 
put message (see “AD”’’) to identify the unlabelled file. 


The end of file recognition for unlabelled files is determined by tapemark count. The TAPE.MARKS option 
allows the operator to specify the total number of tapemarks which will indicate end of file to the utility when 
copying an unlabelled file. The default value is 2. Each tape mark which is encountered will contribute to this 
total. Therefore, a standard labelled CMS file will be copied up to, but excluding, the trailing label if NO.L- 
ABEL is specified by itself.(The standard CMS labelled tape format is “label, tape mark, data, tape mark, la- 
bel’, see CMS MCP manual). The operator must be aware of the format of any file which is to be copied 
when using the NO.LABEL option. 


If the RECORD size is not 180 bytes, refer to the section on Record/Block modifications. 


Example: 


To create a disk file called EMPL from first file of a magnetic tape with non-standard label (the format being: 
LABEL, TAPEMARK, DATA, TAPEMARK): 


COPY TP MTP NO.LABEL TAPE.MARKS 2 TO EMPL 


Note: MCP will issue a message asking for unlabelled tape TP. Operator must respond with “AD” ee 
Additionally, the first record of file EMPL will contain a copy of the non-standard label. 


Record and block sizes 


Record and/or Block sizes may be modified for all file types, input and output. 
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The number of bytes in the record or block is specified using the corresponding ‘‘numbers”. The record and 
block sizes of input disk files are always taken from the file itself (Disk File Header). Record and block sizes 
of non-disk input files are determined as follows: 


Record Size: 
If RECORD is specified, “number” becomes the new record size. 


If RECORD is not specified record size defaults (see below). 
Block size: 


If BLOCK is specified, ‘‘number’’ becomes the new block size. 
If no BLOCK specified, but RECORD is specified, record size becomes new BLOCK size. 


If neither BLOCK nor RECORD is specified, Block Size defaults (see below). 
Default Values: 


Output disk = same as input disk. 

Input labelled tape/cassette = from tape label 
Input unlabelled tape/cassette = 180 bytes 
Cards = 80 or 96 bytes, depending on device. 


If the record size is increased then the additional bytes will be filled with spaces if the input file is a source 
or data file, or with binary zeros for any other type of file. 


Example 


To copy an 80-column card file labelled PROGSRC to a disk file called PROGSRC on a user disk ‘““USR”, 
and make the record size and block size of the disk file 80 bytes and 720 bytes respectively: 


COPY PROGSRC CRD TO USR/PROGSRC RECORD 80 BLOCK 720. 


To copy a disk file PRBU/PR300 to magnetic tape with large blocks suitable for tape media: 
COPY PRBU/PR300 TO PRTAPE MTP RECORD 180 BLOCK 1800 


File size 

The “‘FILESIZE attribute” of a disk file may be specified for the output disk file. Note that only assigned 
areas are copied. This feature does not increase disk space at the time of copying, but allows programs to add 
further records if required. At that time extra disk space may be needed. 


Example: 


To copy FILE1 and increase its “FILESIZE” to 1500, replacing the original by the copy: 
COPY FELEI TO FILE1 FILESIZE 1500 


Single area 


The “SINGLEAREA attribute” may be specified for the output disk file. This ensures that the new file will 
occupy a single disk area. 


Example 


COPY FFLE2 TO FILE2 SINGLEAREA 
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Crunching files 


The “CRUNCH attribute” may be specified for the output file. This causes any unused disk space at the 
end of the file to be returned to the system. 


Example: 


COPY PRB/PR200 TO PRB78/PR200 CRUNCH 


WARNING | 
A file cannot be “‘uncrunched”’ once it is crunched. This means it cannot be extend- 
ed. It can only be used for inquiry. This option is therefore useful for storing history 
files. 


Extending disk files 


Records can be added to the end of an existing disk file with the option “EXTENDING”. The existing file 
must have identical attributes to the file being copied. | 


Example: 


A data file called DFTUES was created with Tuesday’s data. To add this data to the end of a file called 
DFMON (containing Monday’s data): 


COPY DFTUES TO DFMON EXTENDING 
(Note the size of DFMON must be large enough to contain all required records.) 


Selected file copy 


Selected record numbers from the input file may be copied. 


Example: 


To copy 500 records starting at record #1200 from file FILE1 to file FILE2: 
COPY FILE1 1200 500 TO FILE2 


Note: 


pairs of numbers may be specified within each pair;the first number specifies a relative record number and 
the second specifies number of records to be copied. If an extra number is specified, the last number specifies 
copying from that record to the end of the file. 


Example: 


To copy records 100 to 149, 300 to 499, and 1000 to end of file: 
COPY FILE1 100 50 300 200 1000 TO FILE2 


Selected index file copy 
en 


eae u age TONE I 
ppm 


For indexed files, copying of records can be selected based on content of the key. There are 2 options: the 
number of records can be specified, or an ending key value. 


Examples: 


POR is a keyfile containing personnel records. To copy 15 records from the corresponding data file starting 
from the record with personnel #01786 to a data file, PSNL: 


COPY POR 01786 15 TO PSNL 
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Using same keyfile, to copy all data records from personnel #01786 to 18000 to data file, PSNL: 
COPY POR 01786!=- 18000 TO PSNL 


Note: 


The second option is specified by the hyphen in the COPY statement. Note that at least on space is required 
before and after all key values (personnel # in this case). 


sane sh Sh RSS AIRES NOE ~ 
RAN RPE a eS EOE TRIN 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


numbers number IN Error found in pair Check input and 
file name NOT COPIED of numbers for set- reenter. 

ected record copy 

option. One record 

number in the pair 

incicates a section 

of the file address 

than a oreviously 

specified sectton-e 

This pair ts ignored 
by COPY. 


filename EXHAUSTED End"of“file was en” 
countered while the 
section of the file 
indicated was being 


copied. 


filename TO filename Particular attribute Check input 
BAD ATTRIBUTES specifications is rewenter. 
meaningless or in- 

Consistent. The in 

consistencies will 

be in relationship 

between output device» 

record size» and 

block sizes or att- 

empt was made to add 

records to a file 

whose attributes 

differ from those of 

input file. 
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MESSAGE sc 
FILE IDENTIFIER © 
file-name TOO LONG 


filename T filename 
COPY DISCREPANCY 


filename TO filename 
COPIED 


Ifilename T0 filename 
ILLEGAL REQUEST 


filename NOT ACCEPTI=- 
ABLE RECORD SIZE 

OF m EXCEEDS MAXIMUM 
|FOR THIS RUN - 
RESUBMIT 


filename EXKAUSTED 
DURING RANGE record: 
{key number number 
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| SUGGESTED ACTION 
Check input and 
rewerter. 


F s eg 5 CAUSES : 
Copy of a group of 
files was requested. 
At teast one file- 
name that was to be 
generated ty the 
copy would have Leen 
more than 12 charac- 
ters tong» maximum 
length of file-names 
is 12 characters.e 


Endtof“fite reached 
before expected. 
Disk File Header may 
be corrupt. 


COPY successful. 


Check Input arc 
re"=erter.e 


Copy of a group of 
files was requested. 
An individual file- 
name of "SYSMEM*"™ or 
"(spaces)™ was to have 
been producede "SYS" 
MEM™ Ca filer-name 
reserved for system 
use oniy) and 
"(spaces)" are not 
acceptable filenames. 


Check input 
re~erter. 


Copy has encounterec 
a file with a record 
size greater thar 
expected. This can 
happen if a magnetic 
tape file with a 
record $1Ze greater 
than 1024 chérecters 
1s submitted to the 
utility without the 
record size heing 
properly specified 

in the initial input. 


Endrof-fitle encounter None 
ed white section of 

file indicated by 

"record *key™ "nunrber” 

is being copied. 


lfitename FXHAUSTED 
DURING RANGE 


POSSIBLE CAUSES 


No records were 
found ir the rance 


SUGGESTED ACTION 


Check Input and 
remerter. 


"record key” 
I"record=key” 


"record~key” 
"“record=key”. 


NO RECORDS FOR 
COPYING FROM 
filename 


Specified fite 
contains no records 
for copying. 


Check for correct 
filernane. 


Do selective copies of 
the carts of the file 
before and after the tad 
record» as part recovery 


INPUT RECORD number Error encounterec- 
OUTPLT RECORD number utility cannot 
PERMANENT ERROR ON continue. 

INPUT FILE 


INPUT RECORO number Error encounterec” 
OUTPUT RECORD number utility cannot 
PERMANENT ERROR continue. 

ON OUTPUT FILE 


Remove the disk area in 
error with XD utility 
and rerun the COPY 


INPUT RECORD 
number OUTPUT 


“Re-irput the COPY with 
suitebte FILESIZE 


Error encountered 
utility cannot 


IRECORD number continue. option. 
OUTPUT FILE TAD 
TSMALL 
filename TO file- COPY unsuccessful Irr- None. 
mame COPY FAILURE ecoverable error was 
encounterece fhe 
reason should be 
displayec before this 
message. 
NO RECORDS IN THE <BCTH> option was None. 


|KEYFILE = filename used. Utility was not 
able to access to a 
data file through 
some failure in the 


keyfile. 


filename NOT FOUND 
FOR EXTENDING 


Specified file was 
not foundcde 


Check tnptut and 
rementer if necessary>s 
Check for correct 
mediums 

filename REMUVED COPY successful. If 
any duplicate files 
are encountered by 
COPY they are aut>- 
omatically removed. 
Confirms that setect>- 
1on criteria were 
specified when copy= 
ing a pair of files» 
and have been ciscaro™ 
ede. ee | 
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Nonee 


filename 10 tilenaone 
SELECTION CRITERIA 
IGNORED : 


BAD ATTRIBUTES 
SPECIFIED 


filename TO fitename 
EXTENDING FLAG 
IGNORED 
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SUGGESTED ACTION 


Check input anc 
reverter. 


Inconsistent attrib- 
utes were specified 
for input file. 


EXTENDING option was 
ignored by utlity 
when pair cf files 
was copied. 


CP (Compute) 


This utility allows simple computations to be made, with the answer displayed in decimal and hexadecimal. 
Input may be either decimal or hexadecimal. Hex values must be enclosed in @ symbols. 


The utility may be initiated with a single computation to perform, in which case it will do the calculation 
and terminate. If no calculation is initially provided, the utility issues an ACCEPT to enable the computation 
to be entered. In this case the utility will do the calculation and then issue further ACCEPTS until a null input 
to the ACCEPT is given. 


Format: 


CP number number 


+ 
/ 
M 


The numbers accepted are any decimal or hex values in the range 
0 999999999999999/@38D7EA4C67FFF@] 


or the negative equivalent. 

Parentheses are not allowed. The calculation is performed on a strictly left-to-right basis. The operators +, 
—,*,/, and M are for addition, subtraction, multiplication, division and modulus division (the result is the re- 
mainder) respectively. - 


Examples: 


To compute the hexadecimal value of the decimal number 12345: 
CP 12345 


To compute the value of a complex expression: 
CP 555 #3 + 2-100 #2/5 


(Note: the result of the above is 626, because the calculation is done strictly left-to-right). 


Output messages: 


MESSAGE POSSIBLE CAUSES | SUGGESTED ACTION. 


CP : NUMBER TOO At least one number Re-~incut. 
LARGE 1s out of range. 


cP : MISSING Two Consecutive Rewinput- 
OPE RAND | operators (Cts etc) 

have been e€ntered 

With no number 

between- 
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MESSAGE 


CP : HEX. NO. WITH 
MISSING "a" 


CP : INVALID 


OPERATOR 


CP s OVERFLOW 


CP : DIVISION BY 
| ZERO 


4—30 


POSSIBLE CAUSES 


Tilegat symbot; 
or missitrg @2 
symbol at front 
or back of a 
hex value. 


Illegal symbol; 
or an operator 
(+, etc) has been 
omitted. 


An intermediate 
value in the com” 


putatiorn is greater 


thén the maximum 
value. 


Self explanatory. 


SUGGESTED ACTION 


Re-input. 


Re-irpit. 


Rerirptut. 


CREATE (Create Disk File) 


This utility allows the operator to create or extend data or source disk files. The “AMEND” and “UPDATE” 
utilities use many similar features. 


Format: 


FILESIZE number 
CRUNCH 


CREATE | disk-name / Vy file-name | RECORD number 
2 BLOCK number number 
N 


or 


CREATE 7 disk-name / file-name | : | number | 


When creating a new disk file, certain attributes may be specified. 


If the S option is selected, a source file will be created using alphanumeric input. If the A option is used 
a data file will be created using alphanumeric input. The N option creates a data file with hexadecimal (numeric) 
input. If none of these is selected, S is assumed. Alphanumeric input is accepted as typed, but numeric 
(hexadecimal) input requires two characters (0-9, A-F) for each byte of the record. 


The RECORD option allows the operator to specify the number of characters per record of the new file. 
If no record size is specified, a record size of 80 bytes is assumed for source files, and 180 bytes for data files. 


The BLOCK option allows the number of characters per block of a new file to be defined. The defaults are 
as follows: 


If RECORD size was specified but no BLOCK, BLOCK size will equal RECORD size. 


If neither RECORD nor BLOCK is specified, RECORD size will be 80 bytes for source files and 180 bytes 
for data files; BLOCK size will be 160 bytes for source files, 180 bytes for data files. 


The FILESIZE option allows the maximum number of records likely to be written to the new file. This is 
useful in allocating only as much disk space as required by the file. Once the FILESIZE has been specified 
for a file, that file can never be extended beyond that number of records. However, the COPY utility may 
be used for increasing the FILESIZE of an existing file. The default is 2,048 records. 


_ The CRUNCH option allows the operator to specify that the new file should occupy the minimum area of 
disk, but never be extended. 


The numbers specified for the ‘“‘numbers”’ option may be used to set “‘tab”’ positions within the record (similar 
to setting “tabs” on a typewriter). If tabs are set, the operator may input data, press OCK1, and the utility 
will reposition the print mechanism to the next tab position within the record, and await data input. During 
this repositioning CREATE will fill all character positions left unspecified in the record with a “filler” (ASCII 
space for source input, ASCII zero for alphanumeric input, and binary zero for numeric zero). The record length 
plus one will be used as a termination tab position, whether or not other tab positions are specified. 
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,, 4, Pod 
ae "ae a 


eal 


CREATE can be used for record sizes up to 500 bytes, but since the utility cannot be given input greater 


than the width of the console, tab positions are mandatory on files of larger record eines. Kor example. 2 file 
of 180 byte records requiring alphanumeric input will require at least one tab position (for instance at position 
100). A file of 180 byte records requiring hexadecimal input will require a minimum of three tab Ce a (for 
Instance at’ positions 50, 100 and 150). The maximum tab size is 111 in alphanumeric input and 54 in 


hexadecimal input. That is, the difference between two consecutive tab positions should be less than or equal 
to 111 in alphanumeric input and less than or equal to 54 in hexadecimal input. 


The EXTENDING option is used to add records to an existing file. The attributes, such as RECORD and 
BLOCK sizes, are taken from the old file. The filetype is also taken from the existing file. The operator may 
specify “A” alphanumeric input or “N” for hexadecimal input. If neither ‘“‘“A” nor “‘N” is specified, ““A”’ is 
assumed. 


Examples: 


To create a source file called “ICFILE’”, record size 100 bytes with 5 records per block, tab position set at 
65: : 
CREATE ICFILE RECORD 100 BLOCK 500 65. 


To create a source file called ‘“ICFILE”’ with Record Size 80, block 3, and a maximum of 20 records in th 
file: | 
CREATE. ICFILE RECORD 80 BLOCK 240 FILESIZE 20. 


To extend a source file called “ICFILE” (note: the utility will automatically prompt the operator for the next 
sequential record number to be created): 


CREATE EXTENDING ICFILE 


To create a data file called ““CFILE” for hexadecimal input with tab positions set at 50, 100 and 150. (Note: 
‘Default record size is 180, block 1): 


CREATE CFILE N 50 100 150 


The utility operates in two modes: ‘““RECORD INPUT” (entered through PK1) and “RECORD MODIFY” 
(entered through PK2). 


tn Seger aa; ae 
“Ee 


The “Record Input Mode” (PK1) is used to enter new records through the keyboard. Characters are input’ 
followed by OCK1 for each tab position. 


The ‘Record Modify Mode” (PK2) is used to make corrections to the last record input. The point in the 
‘record at which alterations are to be made is selected by typing an identify group of characters immediately 
preceding the byte(s) of the record to be altered. The portion of the record to be replaced or inserted follows 
the identifying characters, delimited by a colon (:). If alterations are to be made at the beginning of the record, 
no identifying characters are necessary. | 


If OCK1 is used to terminate input, the characters to be altered will replace the corresponding number of 
characters in the record. | 


For example, for a record containing “ABCDEP”’, the amendment C:XY:OCK1 will result in\“ABCXYF”. 
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If OCK2 is used to terminate input, the characters delimited by colons (:) will be inserted at the indicated 
point. The insertion can cause characters in the record to be moved to the right. The shifting of characters ap- 


plies only to those characters from the starting byte to the next higher relevant tab position; characters beyond 
this tab position will not be affected. 


For example, a record specified with tab positions at 4 and 8, contains “ABCDEFGHIJ’”. The amendment 
C:WXY: OCK2 will result in “ABCWXYDHIJ”. 


Initially the utility will be in the “Record Input Mode”, and on completion of an entry in any mode, it will 


allow the operator to select the mode not in use, or terminate the utility (with PK6). Unless otherwise instruct- 
ed, it will continue in the existing mode. 


If the FILESIZE is specified and records are entered beyond the given filesize, then the error message is 
displayed after (filesize + 2) records have been entered. The last two records will not be written, due to the 
blocking of the output file by CREATE. For example, if the request 


CREATE ICFILE FILESIZE 15 


is followed by more than 15 records entered, then the message ‘OUTPUT FILE TOO SMALL” will be given 


after the seventeenth record is entered; and the utility will go to EOJ without writing records 16 and 17 to 
the output file. : | 


Output messages: - 


|MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


FILETYPE IS NOT 
SOURCE OF DATA 


A file other than Check for correct 
a “source” file or files check irput 
a “data™ file was and reenter if 

specified. recessarye 


ILLEGAL PARAMETER Specified record and Check Input 
LIST - BAD block sizes are tn” reenter, 
ATTRIBUTE compatible. 


ILLEGAL PARAMETER Tab positions beyond Check input 
LIST - TABS ERROR end of record were rementer. 
specifiteds or ineput 

fields targer then 

capabilities of 

console. 


NOT HEXACEC IMAL Character other than Check tnput 
CHARACTER INPUT = 0-9 ad AF was Inpute. rementer. 
RESUBMIT 


ODD NUMBER OF Warning message Ind” None. Utitity accepts 
HEXADECIMAL CHAR™- icating that an odd the input» but adds a 


ACTEFS INPUT number of hexadecim-=- Zero onto the end 
at characters was Cright) of the inout» 
input. Wher incut to ever it out. 


mode is “hexadecimal™» 
utility expects even 
number of tnout char" 
acters. | 
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SUGGESTED ACTION 
INPUT ERROR = Input error during Check input and 
RESUBMIT RECORD "Record Modify Mode". reenter record 
MODIFICATION modificatione 
BYTE WITHIN The identifying Check input and 
RECORD SPECIFIED string of charact= rementer the 
NOT FOUND ers for record record modification. 


modification could 
not be found in the 
record specified. 


UNWANTED KEY Invatid OCK was Rementér input and 
PRESSED =- PLEASE pressed. termirete the entry 


RE“INPUT. rhith the correct OCK. 


INPUT IMMEDIATELY Chéeracters were input Restért the utility 
BEFORE PK6& HAS Immediately before usinc nodify mode to 
BEEN LOST PK6 was pressed to Correct this record if 
terminate the utility. cdesirec. 
These characters witt 

not be written to 

the specified file. 


OUTPUT FILE TOO Attempt was made to List the file to 
SMALL add records to check which records 


specified fite have been entered: 
beyond its maximum then use CREATE 
filesize. File is | EXTENDING to add 
closed with tock. the cesired records. 


Alternatively use 
UPDATE with the 
FILESIZE option. 


PERMANENT ERROR ON Utility 1s not able List the file to check 
QuTPUT FILE to write any- more which records have 


records to the new teen entered: then 
disk file because CCPY to a different 
of errors on the file a@nd continue 
disk- File is closed using CREATE 


with lock. EXTENOING. 


RECORD SELECTION Attempt was made to Check input and 
ERROR select a non~exist- re-enter if 
ant record. recessary. 


ILLEGAL RECORD | Attempt was made to Check input and 

NUMBER SPECIFIED select record greater reenter if 
than the number of recessery. 
records in file» or 

Zeroe 
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SSAGE POSSIBLE CAUSES SUGGESTED ACTION 


RECORD REQUESTED 


Attempt was made to Usuatty indicates 
IS BEYOND E£.0.F. Select record teyond tpdate is complete: 
end of file- utility terminates 


normétly» no action 
reed be taken. 


£E.0.F. REACHED Attempt was made to Usually indicates 
DURING DELETIONS delete a record file update is 
beyond end of file. complete: utility 

terminetes normally» 
no action need be 

taker. 


FILE TYPE IS NOT Input type A or N has Check the file type 

DATA been specified and and rewingut correct 
the type of file given file tyne. 

for extension is not 

datae 


Note: Refer to “Common Utility Output messages” for additional messages 
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DA (Disk Analysis) N 


This utility allows the operator to read any portion of a CMS- format disk. It 1s an interactive program, with 
the operator entering a range of commands via the console. 


The utility is commonly used to print the contents of the disk directory. In general, if the PD utility operates 
correctly for a specific disk, then DA should also run successfully. Specifically, the disk cartridge label, the name 
list entry. and disk file header for SYSMEM must be intact. (Refer to the CMS MCP manual for details of 
the disk format and directory structures). 


disk-name | / file-name / 


The utility operates in two modes “disk mode” and “file mode’’. If no file name is specified the utility oper- 
ates in “disk mode”. If no disk-name is specified, the system disk is analyzed. 


Disk Mode 


Format: 


DA 


In this mode the operator can enter via the keyboard a number of commands. These commands can be abbre- 
viated according to the table provided at the end of this section. The format and meaning of each command 
in disk mode is given below. : 


END 


Terminates the utility. 


DCL 


Reads and formats the contents of the disk cartridge label. 


DFH 


‘Reads and formats the contents of selected disk file headers. This command is followed by other details, given 
here: 


TEMPORARY 
ALL 
OF file-name 
DFH number 
~@ number 
NEXT 


The “TEMPORARY” option displays the headers of all temporary files. 
The “ALL” option displays the headers of all files, and their contents if in use. 


The “OF” option displays the header of the specified file: all headers will be checked and duplicates will 
be displayed if found. 


The “‘sector-number” option displays any sector in disk file header format, where the number is a decimal 
sector address. If preceded by an @symbol, the sector-number is 1n hexadecimal. This feature can be used after 
displaying other parts of the directory, which include sector addresses for disk file headers in hexadecimal. 


The “NEXT” option displays the header of the next file in the directory. 
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AVAIL. TABLE 
Reads and formats the contents of selected parts of the disk available space table. This command is followed 


by other details, given here: 


ALL 

AVAILABLE 
AVAIL.TABLE BAD 

INVALID 

number 

@ number 


The “ALL” option displays the entire available table. 
The “AVAILABLE” option displays entries for available area only. 


The “BAD” option displays entries for bad sectors only. 


The “INVALID” option displays all entries in the available table which are invalid, in that the “length” entry 
does not equal the difference between “start address” and “end address”. 


The “‘sector-number”’ option displays any sector in available-table format, where the number is a decimal sec- 
tor address is in hexadecimal. 


NAME.LIST 


Reads and formats the directory name list, including the sector addresses of associated disk file headers. This 
command may be followed by other details, given here: 


NAMES 


TEMPORARY 
NAME.LIST OF file-name 


number 
@ number 


If no further details are given, then the entire name list is displayed. 
The ‘““NAMES” option displays entries for old (existing) files only. 
The “TEMPORARY” option displays entries for temporary files only. 


The “OF” option displays the entry for the specified file : all entries will be checked and duplicates will be 
displayed if found. | 


The “‘sector-number’” option displays any sector in name-list format, where the number is a decimal sector 
address. If preceded by an @ symbol, the sector-number is in hexadecimal. 


READ 


Reads and displays the contents of any specified sector in hexadecimal and ASCII format. This command 
may be followed by other details, given here: 


NEXT 
READ ONLY number 
@ number 
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The “ONLY” option inhibits the display of the information. 

The “NEXT” option will read the next sector. Note that after some operations which involve a search, the 
“next”? sector may be indeterminate. After a READ of sector n, a READ NEXT will read sector n+l. A 
READ command with no further details is taken as a READ NEXT. 


The “number” option reads the sector whose address is the number. If preceded by an — symbol, the sector- 
number is in hexadecimal. 


DISPLAY 
Displays the current sector address and contents of the program’s sector-buffer. The first DISPLAY command 


must be preceded by a READ command. A READ ONLY followed by a DISPLAY is equivalent to a normal 
READ. 


KFPB 


The Key File Parameter Block of a keyfile can be printed. 
KFPB OF file-name 


If the file specified is a key file, then record 1 of that file is selected and the information is printed. 


PPIT 


The Pseudo Pack Identification Table can be found from the Disk Cartridge Label and requested information 


may be printed: 
| number 
pp) 3 NAMES 
ALL 


OF disk—name 


~The “number” option displays the sectors from the PPIT. 
The “NAMES” option displays the used entries of the PPIT. 
The “ALL” option displays every sector of the PPIT. 


The ‘OF disk-name”’ option displays the entry for that disk only. 


File Mode 
In file mode, the utility can be used to read selected records. Only the following commands are valid: 
READ 
DISPLAY 
END 


The READ command has the same format as in disk mode, except that the “number” refers to the logical 
record number in the file, and a READ NEXT will read the next logical record in the file. The amount of 
information displayed is equal to the file’s record length. In DISPLAY option, if the file is a key file, then 
the KFPB of that key file is displayed. 


General Notes 
In disk mode the sector number starts from zero; that is, ““READ 0” will read the first disk sector. 
In file mode the record number starts from one; that is, ‘““READ 1” will read the first logical record. 


Any I/O error causes the “fetch value” to be displayed, with the current sector address if in disk mode, or 
current record number if in file mode. 
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Abbreviations 


For ease of use, input commands and other keywords may be abbreviated, as in the following table: 


READ 

ONLY 

NEXT 
DISPLAY 
END 

DCL 

DFH 

ALL 

OF 
TEMPORARY 
AVAIL.~TABLE 
AVAILABLE 
BAD 
INVALIO 
NAME.LIST 
NAMES 


Output messages: 


[MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


OUTWITH format AREA In disk mode the None. 
ADDRESS: number sector which has. been 
LENGTH number specified to be read 


an OF Hs» NAME LIST> 
AVAILABLE TABLE or 
PPIT format is outwith 
relevant area. 


The KFPB option has 
been requested and 

the file which was 

specified 1s not a 

keyfile. 


FILE IS NOT & KEYFILE 


NOT FIXED DISK SYSTEM The PFIT option has 
been requested on a 
non-Fixed Lisk system 
and no Pseudo Pack 
Identification Table 
existsSe | 


DA TERMINATED The EAD commanc 
successful. 


ILLEGAL PARAMETER No valid disk name Re-enter 
PF input of file name has 
| been specified in 


the initiating 
messagee« 
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[MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 
SUCCESSFUL READ A DISPLAY command Enter a READ ccmmandr 


REQUIRED FIRST has been entered then a DISPLAY will 
cefore a success= wWOr ke 


ful read. 


NOT VALIO IN FILE A command other than Check tnput. 
MODE READ or DISPLAY has 

been usec in file 

mode. 


| NONE FOUND No information has 
jor been found In answer 
NOT FOUND to a command. 


READ ERRGR ON DCL An error was None. | 
iOF disk=name encounterec while 

reading sector zero of 

the specified cisk.e 


PARAMETER REQUIRED The option which has Re-input the complete 
been specified 1s ootion. 
incomplete. 


LAST OPTION The DISPLAY option has Perform a read before: 
UNSUCCESSFUL teen requested before using display cption.| 
a sector or record has 
teen read or after an 
option has been 

unsuccessful. 


ERROR ON READ@- The disk parity error 
has been encountered 
white reading a record 
in file mode. 


ERROR ON READ- The disk parity error 

ADDRESS:*°*"=- has been encountered 
while reading a record 
in disk modee 


BEYOND END OF FILE= A record beyond end of 

RECORD: *--*" file has been 
requested to be read 
while in file mode. 


INVALID SECTOR- A sector acdress 

ADDRESS:---- beyond the last 
physical sector of a 
disk has been specified 
to be read while in 
disk mode. 


DD (Disk Dump) 


This utility allows the operator to back-up (“STORE”) one or more files from a disk to one or more disks 


(cartridge or BSMD) whose capacity is less than the originating media, and later “RESTORE” these files to 
their original state. — 


Store Function: 


Format: 
. file-name or file-name or 
DD STORE disk-name / group-name TO disk-name / group-name 


The STORE function allows the operator to store a file or group of files between two disk media, where 
the size of the file may be greater than the physical size of the disk to which the file is being copied (destination 
disk). The files to be stored are specified by “‘file-name” or ‘“group-name”’ and are taken from the system disk 
unless “‘disk-name”’ is specified. Additional files or groups of files may be specified, separated by a comma. 


When the original destination disk is filled, the utility will request the name of the next disk to be used. The 
disk name is accepted from the operator who should then power off the drive using the ‘““PO”’ intrinsic, insert 
the new disk into the drive, and use the “RY” intrinsic to allow the utility to continue. When all the files have 
been copied, the original destination disk must be re-inserted before DD will go to End of Job. 


STORE re-computes block sizes for optimization and to allow a file to be copied to multiple disks. As a re- 
sult, these files will not be usable as in their original form. The files must be RESTORED. 


Examples: 


To store a file called PR200 from the disk PRI to the disk PRBU: 
DD STORE PRI/PR200 TO PRBU/PR200 


To store a group of files beginning with the letters “PR” from the disk PR2 to the disk PRBU: 
DD STORE PR2/PR= TO PRBU/PR= 


To store a file called PRCLEF from the system disk to the disk PRBU: 
DD STORE PRCLEF TO PRBU/PRCLEF 


The information needed to restore these files is kept in a file called ““DDSTRESTORE” which is created 
when DD begins processing. Because of this, DD may not be run twice to the same destination disk or the 
information required to restore the first set of files will be lost. 


Restore Function 


Format: 


file-name or file-name or 
DD RESTORE disk-name / group-name TO disk-name / group-name 


This option allows the operator to restore a file or group of files between 2 disks where the disk from which 
the files are being copied (source disk) was generated by “file-name” or “group-name”’. Files are copied to the 
system disk unless ‘“disk-name” is specified. Additional files or groups of files may be specified, separated by 
a comma. 
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When all files have been restored, the. utility will inform the operator what disk must be inserted next to 
continue the transfer. Power off the disk drive using the ‘““PO” utility, insert a new disk, and use the “RY” 
intrinsic to continue the utility. 


Examples: 


- To restore a file called PR200 from the disk PRBU to the disk PRI: 
DD RESTORE PRBU/PR200 TO PR1/PR200 


To restore a group of files beginning with the letters “PR” from the disk PRBU to the disk PR2: 
DD RESTORE PRBU/PR= TO PR2/PR= 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTICN 


group7name ~~ NO Specified group Check input and 
FAMILY MEMBERS 7S not on disk. revernter if necessary; 
FOUND Check for correct 

| cisk. 


FILE NAME TOO Specified fite Resinput correctly. 
LONG name is tonger 
then 12 characters. 


filename NOT Attempt was made to 
STORED = ILLEGAL store a system file 
REQUEST (that is» MCP» 

| interpreters» etc). 


ENTER NEW PACK ID Program requests Enter AX mix number 
FOR CONTINUATION next disk for cf procram and new 
OF TRANSFER © | STORE continuation Cisk néme to which 

ACPT disotlay- STORE witt continue 
to copy. 


INSERT PACK disk= Continuation disks Respond to ACPT mess 


name FOR CONTIN- are required. age with AX mix number 
UATION OF TRANSFER | disk?name- Power 
INSERT NEWPACK off (PO) disk 
disk*name FOR currently filled», 
CONTINUATION OF Insert new disk» type 
RESTORE | : "RY" to contirue 


procéssing. 


NOT FIRST PACK OF Source disk specified Fower of f (PO) ins 
A STORED SERIES in RESTORE 1s not apercpriate disk» 

PACK disk-name first disk of a stor” Insert proper cdiSke 
REQUIRED ed series of disks. 


filename STORED STORE or RESTORE None. 
TO filename successful 

filename RESTORED 

TO file-name 


NOTE: Refer to “Common Utility Output Messages” for additional aid. 
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DUMP (Dump Files to Library Tape from Disk) 


This function, a part of the LD allows the operator to copy files from disk to library-tape. 


Format: 


| LD | DUMP TO library-tape-name | FROM disk-name 
file-name or 
group-name <BOTH> 


If the <BOTH> option is used following a request to dump a keyfile, the associated data file will also be 
dumped following the ae on tape, provided the data file is on disk. 


Examples: 


To dump a group of files beginning with the letters “AR” from the system disk to ARTAPE: 
DUMP TO ARTAPE AR= | 


To dump a file called ARTASK and a group of files beginning with the letters “DCS” from a disk called 
ARDISKI1 to a tape called ARTAPE: 


LD DUMP TO ARTAPE FROM ARDISK1 ARTASK DCS= 


To dump a keyfile called AR200K and its data file from a system disk to ARTAPE: 
DUMP TO ARTAPE AR200K <BOTH> 


Since “DUMP” is a part of the utility “LD”, “LD” is actually what will appear in a mix message. To discon- 
tinue the DUMP function, ‘DS” mix number/LD must be used. 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


Specified group name Check input anc 

not found on disk. re-enter 1f necessary; 
Check for correct 
Cisk. 


NO FILE fit etname Specified file was Check input and 


ON DISK disk*name not found on disk-e rementer if necessarys 
OR DUMP Check for correct 
ecisks 

file-name NOT | File to be copied is None: utlity will 
DUMPED = IN OUTPUT In use and cannot be not dump this file 
USE DUMP ABANDON- copied. If "NUMP but will continue 
ED TAPE BEING ABANDONED™ message 1s with next file to 
PURGED. given» tape 1S purged be dumcted. 

and utility goes to 

FOJ. 
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| MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


filename NOT File to be copiec was None 
DUMPED - HAS BEEN removed between start 
REMOVED. of DUMP and time when 
DUMP ABANDONED - file was to be copiec 
TAPE BEING PURGED. to tape. Tape is purced 

and utility coes to End 

of Joh. 


file-name NOT Contents of file to 
DUMPED = HAS BEEN be copied were alter- 
ALTERED = OUMP ed between the start 
ABANDONED = TAPE of the dumo and the 


BEING PURGEDO. time the file was to 
be copied to tape. 
Tape 1s purged and 
utility goes to Eng 
of Job. 


filename LOAD/ End of Fite reached None. 
DUMP DISCREPANCY before expectec. Disk 

File Header may con” 

tain errors. 


NO FILES TO No files were found Check input and re- 


DUMP on this disk to copy enter if necessary> 
to tape. Check for correct 
tape. 


filename DUMP successful 


DUMPED 


DUPLICATE filename More than cne recuest None. 
ALREADY BEING was made to DUMP this 


DUMPED file. 


file-name NOT <BOTH> option was If specified cata 
DUMPED = DATA FILE specified» but data file dump 1s 


NOT ON LINE file was not found required» supply 
on diske DUMP with backup 
Copy of fite if it 
exists. 


_ Note: Refer to “Common Utility Output Messages for additional messages. 


ECMA.LD (LOAD/DUMP OF ECMA TAPE FILES) 


This utility allows the operator to structure tape files according to ECMA BASIC and ECMA COMPACT 
systems as specified in the STANDARD ECMA-41 publication. 


The ECMA tapes are treated as unlabelled tapes in the CMS system. The utility is initiated in two different 
ways for BASIC system and COMPACT system. 


BASIC INITIATION 


Format (Disk to Tape copy) 


DUMP | | nN | as | 
ECMA. LD or FROM disk-name © file name 


UNLOAD 


The files are copied from the disk to a purged tape. If the option UNLOAD is specified then the files copied 
are removed from the disk. 


Format (Tape to Disk copy) 


ECMA.LD LOAD | TO disk-name vy | RECORD number | BLOCK number W 


The files are copied from an ECMA BASIC tape to the disk specified by disk-name. The option RECORD 
followed by a number specifies the record size in bytes on the tape and BLOCK followed by a number is the 
blocking factor, that is, number of records per block. 

If the RECORD and BLOCK options are used then the first file on tape is read according to the first attri- 
butes, the second file is read according to the second attribute etc. If the block size (that is, record size x num- 
ber of records per block) exceeds 256 then an error message is issued and loading is not performed. 

If RECORD and BLOCK options are not used then tape files are loaded as 256 byte records blocked 1. 

The names of the ECMA tape files loaded to the disk become ECMA001, ECMA002,....ECMA0OQOn. 
Examples: 


To copy files IN001, INO02 from the systems disk to a tape in ECMA BASIC format: 
ECMA.LD DUMP INO001, INQ02 


To copy file AR030 from the disk ARDISK to a tape and remove after copy: 
ECMA.LD UNLOAD FROM ARDISK AR030 


To copy files PR200, record size 80 block 160, PR210, ee size 60 block 180, to the system disk from 
ECMA BASIC tape on device CTA: 


~ECMA.LD LOAD RECORD 80 BLOCK 2, RECORD 60 BLOCK 3 


The utility will display the following message: 
mix no/ECMA.LD <14> WAITING UNLAB ECMATAP/NONE AT DEVICE REQUIRED 


‘Then enter: — 
AD mix number CTA 


| The files PR200 and PR210 will be called ECMA001, ECMA002 on the disk. 
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COMPACT INITIATION 


Format (Disk to Tape copy) 


DUMP | | A | 
ECMA.LD roe TO tape name FROM diskname file name 


The files are copied from the disk to tape. If the option UNLOAD is used then files copied are removed 
from the disk. 


Format (Tape to Disk copy) 


LOAD | ‘ | y 
ECMA.LD or FROM tape-name TO disk name 
ADD 


File name RECORD number | BLOCK number W 


The files are copied from an ECMA COMPACT tape to the disk specified by disk name. If any file is already 
present on the disk, it will be removed before the same named file is copied. The option RECORD followed 
by a number specifies the record size in bytes on the tape and BLOCK followed by a number is the number 
of records in a block. 


If RECORD and BLOCK options are used then the first file on the tape is read according to the first attri-. 
bute and the second file is read according to the second attribute. If block size (that is, record size x number 
of records per block) exceeds 256 then an error message is given and utility will terminate. 


If RECORD and BLOCK options are not used then tape files are loaded as 256 byte records blocked 1. 


The ADD option will copy a file to the disk only if that file is not already present. 


Examples: 


To copy files INO01, INO02 from the disk INDISK to a tape FRED in ECMA COMPACT format: 
ECMA.LD DUMP TO FRED FROM INDISK INO01, INO02 


To copy files INO10 from the system disk to a tape FRED and remove from the disk after copy: 
ECMA.LD UNLOAD TO FRED INO10 


To copy files from tape FRED on CTA which is created in ECMA COMPACT format files INOQ1, INO02 
to the system disk: 


ECMA.LD LOAD FROM FRED IN001 RECORD 80 BLOCK 2, INOQ02 


The utility will display the following message: 
Mix number/ECMA.LD <14> WAITING UNLAB ECMATAP/NONE AT DEVICE REQUIRED 


The response should be: 
AD mix number CTA 


446 


Output Messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
NOT A BASIC ECMA Loading is requested Check the tape and 
TAPE from a BASIC tape but reminput 


the tape is not 
a BASIC format 


NOT A COMPACT ECMA Loading ts requested Check the tape and 
TAPE from a COMPACT tape’ reminput 

but the tape 1s not 

a COMPACT format 


NO FILES IN THE FAMILY Specified files are Check the group name 
groupsname ON TAPE not present on the and/or the tapes and 
tape-name FOR DUMP/ tape  reminput 


LOAD/ADD/UNLOAD 


NO FILES IN THE FAMILY The specified group Check the group name 
grouposname ON DISK of files is not and rewinput 


FOR DUMP/SLUOAD/ ADDS present on disk 


UNLOAD | | 
NO FILE filename UN The specified file Check the file name 
TAPE tapew~name/DISK is not present on and reinput 
disk=name FOR LOAD/ tape or on disk 

DUMP/ADD/UNLOAD 


file-name REMOVED This message is 
| displayed for each 
file removed by a 


LOAD or UNLOAD 


filename LOADED This message 1s none 
dispiayed for each 
file added or 


Loaded 


filename DUMPED This message 15s none 
dispthayed for each 

file dumped or 

unloaded 


file-name NOT LOADED- Self~explanatory 


ALREADY ON DISK 


The file is not Check input and 


file-name NOT FOUND 
| found on disk re~enter 


file-name HAS BEEN The specified disk 
REMOVED = DUMP file to be copied to 
ABANDONED = TAPE tape has been reaoved 
BEING PURGED | before the utility was 
| able to copy it 
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filename HAS BEEN 
ALTERED = DUMP 
ABANDONED ~- TAPE 
BEING PURGED 


file-name IN OUTPUT 
USE = DUMP ABANDONED = 
TAPE BEING PURGED 


|BLOCK COUNT ERROR 


INCORRECT TAPE NAME 


NOT FIRST PART OF FILE 


DAFA BLOCK TOO LARGE 


file=name DATA FILE 
NOT FOUND ON TAPE 
FOR LOAD 
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[MESSAGE ~ POSSIBLE CAUSES SUGGESTED ACTION 


The contents of the 
file to be copied to 
tape were altered 
after the start of 
the dump and before e 
the utility was able 
to copy it 


The file cannot be 
dumped to tape as it 
is being used as an 
output file 


possible bad tape: 
retry with a 

different drive or 
with a backup tape 


This 1s displayed when 
the BLOCK COUNT entry 
in the end-of- file 
label» end-of-track 
label» or endof=votume 
label does not match 
with the actual number 
of blocks read during 

a LOAD or ADD 


For a COMPACT format 


Check the tape label 
tape» the names in the andrewinput 
initiating message and 

the tape label do not 

agree 


A section number 

other than 1 was found 
when reading the first 
label on tape 


The block size on 
tape for a LOAD or 
DUMP is greater than 
256 bytes 


Check file name and 
re~input if 
necessary 


File specified for 
COMPACT format LOAD 
cannot be found 


FL (Display File Attributes on Self-Scan) 


This utility allows the operator to display detailed information about particular files or groups of files on disk 
upon the self-scan screen. The information given is similar to the LR utility. 
Spo sce omar crip als? da 


“stator tssr samen natrendeneyyerennanunenarrevsnnvets 


"Sentech aN 


file-name or 
FL disk-name / group-name 


Seronntan neem 


Format: 


The utility uses the following PKs when more than one file is specified: 


Examples: 


To display information about all entries on the system disk: 
FL = 


To display information about a file called PR200 found on disk called PR2: 
FL PR2/PR200 


To display information about a group of files beginning with the letters “PR” found on the system disk: 
FL PR= 


~Qutput format: 


The utility will fill eight lines on the self-scan screen with information about one file. 
line 1: FILE NAME (DDDDDDD/FFFFFFFFFFFF) 
line 2: FILE TYPE (TITTTTIT) 
line 3: SIZE: ACTUAL (XXXXXXX) MAX (XXXXXXX) 
lines 4,5: headings 
line 6: DATE CREATED (YYDDD), LAST ACCESS DATE (YYDDD), 
RECORD SIZE (XXXXX), RECS/BLOCK (XXXXX) 
line 7: AREA MAP (seeeeuseewse ) 
line 8: OVERFLOW ON DISK (DDDDDDD) 


Note that the OVERFLOW ON DISK will not be displayed if the file has no overflow areas allocated. 
The first line contains disk name specified by DDDDDDD on which the file specified by FFFFFFFFFFFFF 


resides. 
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In the second line the FILE TYPE entry will contain one of the following: 
SYSTEM (system file) 
CODE COMPILED YYMMDD (object code file and compilation 
date) 
DATA (normal data file) 
SRCELANG (source language file) 


The third line displays the actual file size and maximum file size specified for the file. 


The fourth, fifth, and sixth lines display the date of creation and the date the file was last accessed in 
YYDDD (Julian) date format. The record size displays the number of characters per record and RECS/BLOCK 
displays the number of records per block. 


In the seventh line sixteen characters are displayed to show the allocation of the sixteen areas into which 
a file may be broken. Each character may be one of the following: 


* unallocated 
B allocated on this disk 
O allocated on the overflow disk 


Output messages: 


SUGGESTED ACTION 


POSSIBLE CAUSES 


disk*name/filename 
NOT FOUND IN OISK 


disk*name/fite"name 
NO FILES FOUND IN 


Note: Refer to “Common Utility Output Messages” for additional aid. 
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Specified file not Check input and 


found on this disk. 


Specified group was 
not found on this 
disk. 


re~irodut if necessary > 
Check for correct 
cisk.e 


Check input and 
re"minput if necessary>s 
Check for correct 
cisk.e 


~ i 
a a 

f Sapa poriaes” EGE 
CA 72 


| “Fons: 


FS | disk-name / file-name INTO | disk-name / file-name 


if!) f The “‘file-name’’ identifies either a data file_or_a_keyfile. If a _keyfile has been specified, the name of the _ 
W data file is obtained from the he information held in the keyfile. —~- 4 


i 


// _If a keyfile is specified, then the utility will reconstruct this keyfile so that it relates to the modified. data. 


esetseunverncenniven tone 
vem! 


While the he utility | is processing, no other ‘Program may access s the d. data file (or the keyfile if one Is specified). _ 

If only one file-name is specified a no other options are used, the file squash will be carried out in place, 
and no new data file will be created. If a keyfile was specified, then a new keyfile with the same ‘file-name”’ 
will be recreated by the SORT. 


If 2 file-names are specified; the data file will be squashed into a new file, and the keyfile (if specified) will }j}— 
be recreated by the SORT. If the first file-name specifies a keyfile, then the new keyfile will have the name {| 
indicated by second file-name, and the new data file will have the name of the new keyfile name, with the } 
letters “QQ” attached to the end of the name. 


Examples: 


To squash the file, PR200: 

| | FS PR200 : 

To squash the file, PR200 and create a new file, PR200B: 
FS PR200 INTO PR200B 


Output_messages: 
MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


filename SQUASHED FS successful. 
FROM n RECORSS TO Original and result- 
m RECORDS ing fliesizes of the 
| data file indicated. 
*n" and “m™" are 
decimat numders up 
to 7 digits each. 


KEYFILE file-name "fite-name”™ indicated 
RECONSTRUCTED by operator itnout 
| identified by keyfile 
ano FS has success™ 
fully squashed the 
data file and recon- 
structed the keyfite. 
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POSSIBLE CAUSES SUGGESTED ACTION 


KEYFILE SORT | SORT utility was not None. 
FAILURE able to property con- 
| struct a keyfile. 


RECORD SIZE TOO An attempt has been 

GREAT made to squash a 
file with a record 
Size greater than 
100900 bytese 


ZIP TO SORF FAILURE - When attempting to Ensure that SORT 

END OF JOB | reconstruct the and SORTINTRINS 
keyfiles the utility are present on the 
failed to execute disks and rewinpute 
SORT. 


Note: Refer to “Command Utility Output Messages”’ for additional aid. 
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ICMD (industry Compatible Mini Disk Access): 


This utility allows the operator to access industry-compatible mini disks (ICMD). 


Format: 


CMD LR disk-name 
or | , | 
}CMD PG disk-name TO disk-name owner name y 


ICMD COPY disk-name/file-name ICMD TO disk-name/file-name FILESIZE number 
or 


ICMD COPY disk-name/file-name TO disk-name/file-name [eicmp 


The first function of the utility (LR) allows the operator to print the disk directory of the ICMD. The utility 
will print a line of information for each file on disk. 


The second form of the utility (PG) allows the operator to purge (erase) all files from an ICMD. The utility 
will replace all files by a single zero-length file called “DATA” to which is assigned all the disk space available 


to the user. By specifying TO’, the operator may change the disk’s name to the second name, and in this case 
the owner’s name may be set or madé_blank. 


The third form of the utility allows the operator to copy an ICMD file to a CMS file. The CMS file will 
have the largest block not exceeding 180. If the FILESIZE of the CMS file was not specified, it will be calcu- 
lated from the header of the ICMD file. Note that when copying a Multi-Volume File (file which resides on 
more than one disk) the FILESIZE option will almost certainly be required. 


The fourth form allows the operator to copy a CMS file to an ICMD file. The maximum record size of the 
CMS file must be 128 bytes (the ICMD sector size). The option ’B’ allows the copying of any file without the 
loss of attributes, but it may be copied back by this utility only. 


Examples: 
To print the disk directory of an ICMD disk called PR2: 
ICMD LR PR2 


To purge all the files from the ICMD called PR2 and name it as PR3: 
ICMD PG PR2 TO PR3 | 


To copy a file called PR200 from the CMS disk called PRI to an ICMD disk called PRBU: 
ICMD COPY PRI/PR200 TO PRBU/PR200 ICMD 


To copy a file called PRFILE from the ICMD called PRBU to the CMS disk called PRI: 
ICMD COPY PRBU/PRFILE ICMD TO PRI/PR200 


Output messages: . | : 
MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


ENTER VOL-IO FOR Program 18 about to Enter eppropriate 
"file"name” n disolay an ACPT re- cisk*name-. 
| questing the next 
disk*name contain= 
ing the Multi-Volume 


File “filename”. 
"n” is the sequence 
number to be used» 
or btank tf none. 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


VOLUME n OF “file= Sequence number “n" Remove inappropriate ' 
name™ OUT OF SEQUENCE of “filename” was disk from disk drive 
not expected at this (PQ cannot be uSed 
pointe with ICMD). Replace 
(Ex: program was with cisk having 
expecting cisk with correct Sequential 
sequence number of number for this file. 


2 and operator st- 
pptied disk with 
Sequence number 4). | 


DUPLICATE FILE File cannot be copiec Copy this file while 

"file name” to ICMD as a file changing its name. For 
of the same name example» if filename 
already exists. Disk MYFILE is already on 
cannot Contain 2 the IC¥D,» enter ICMD 
files with the same COPY DISK/MYFILE TO 
name e ICDISK/YOURFILE I[CWN. 

NO FREE LABEL ON Fite cannot be copted FReptece ICMD with 

"disk-name” to ICMD as its disk another ICMD having 
directory is full. cirectory space. | 

 Rerattempt ICMC utility, 


NO SPACE FOUAD | File cannot he coptec FG ICMC and rewattempt 
ON "disk~name”™ to ICMD as no unused copys or select another 


space coulc be founc-. cisk or which to copy. 


Note: If any of the above messages (including ‘“‘disk-name” .NOT FOUND and “file-name’? NOT FOUND) 
is output in response to the initiating message, the utility will go to End of Job. If in response to an ACPT, 
the utility will repeat the message: ENTER VOL-ID FOR “‘file-name” “n”’. | 


BAD INDEX TRACK ICMD has an €rror on Select another [CMO 
ON disk-name SECTOR Track 0 and cannot for this function. 
number be used by this ut™ 

itity. Utility goes 

to £OJ. 


RECORD SIZE OF The file cannot be Use MCP COPY ctility 


filename EXCEEDS copied to the ICMD to change record/ 
1238 as its record size -lLock sizes. 
1s more than 128» (EX: cOPY cCMSFILE TO 
the maximum for @n CMSFILE RECORD 128» 
ICMD. Utility goes BLOCK 128) 
to ECJ. Then use ICMD COFY 
to comcelete transfer. 
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POSSIBLE CAUSES 


No more disks may 
be usede as the 
maximum for an ICMD 
is 99. Utility goes 
to EOJ. 


OF filename EXCEEDS 
99 


-INPUT ERROR ON 
file=name SECTOR 
number 


Irrecoverable error 
was found on reac 


| from the ICMD. Util= / 
| ity goes to ECJ. fe 


Irrecoverable error 
was found on writ/ing 
sector “number™ /to 
the ICMD. : 


OUTPUT ERROR ON 
filename SECTOR 
number 


file-name TO 


ICMp COPY function 
filename COPIED 


successful + / 


disk=name PURGED ICMD PG function 


successful. 


The requested file 
has the wrong file 
type for this use. 


file-name IS NOT 
TYPE SOURCE GR 
DATA 


The’ CMS file was 
removed by the utility 
to make way for 
another file being 
feopied from an ICMD. 


filename REMOVED 


Note: Refer to Common Utility Output Messages for additional aid. 
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“Use MCP COPY utility | 


V 
tu 
va 
SUGGESTED ACTION 


to break file (see 
COPY utility). Then 
use ICMD COPY to 
complete transfer. 


File cannot be copied| 


/from the ICMDs use 
ing sector “rumber® a 


backuo ICMD 
eble. 


if avail-. 


Qisk cannot be used. 
Use another ICM). 


Noree 
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IR (Initiate Log Recall) 


(a function of SYS-SUPERUTL) 


This function will initiate recall and go back in SYS-LOG files after skipping the number of entries specified 
by the operator (that is, 5 digit ‘“‘offset’) and display the required message. 


Format: 


IR offset. 


Examples: 


To initiate recall after 12 entries and display the message on the console: 
IR 12 | 


To initiate recall of the message just given: 
IR 1 | 


Output messages 


POSSIBLE CAUSES SUGGESTED ACTION 
CANNOT LOCATE DESIRED The tog files have None. 
LOG ENTRY been transferred 


using TL utitity 
Offset is greater Decrease the value of 


than number of entries offset and reenter. 
in log file 
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KA (Analyze Disk Space Assignment) 


This utility provides the operator with a map of all space used on disk by specific files, or available for other 
use. The printout is in ascending disk address order in terms of areas and their assignment. 


KA is capable of analyzing space assigned to one or more files, one or more groups of files, or the available 
areas. 


Special reporting is given if the group identifies all files on the disk (that is, disk-name/=). In addition to 
an analysis of the areas allocated to each file, this report will show the space assigned to the disk directory, 
temporary, available, bad, and missing areas. The temporary areas are those which are allocated either to tem- 
porary files or to the virtual memory. 


If files are created, extended, or deleted by the system during the processing of KA the map will not be 
accurate. It is therefore necessary that KA be run only when no other programs are in the mix. 


The analyzed output will be to a line or console printer, and will print the areas in ascending disk address 
order associating with each area its first sector address, its length in sectors, and its status. The status will be 
either allocated, available, temporary, bad, or missing. If the area is allocated, the file name of the file to which 


the area is assigned will also be listed. If a particular file or family is not on-line, then this is indicated on the 
printout. | 


_ If the option DSKAVL is selected, then an analysis of the available areas on the disk specified by “‘disk- 
name” (or system disk if no “disk-name” was specified) will be printed. | 


Format: 
oe file-name or 
KA _-~ disk-name / group-name 
Or j J a roe ee, eee a ho. 4 bos, A Coton ‘ A fet if etl - ee ; oN ae 4 
KA disk-name — DSKAVL ae —_ 
Examples: 


To analyze disk space assignments of all files on system disk: 
KA = 


To analyze disk space assignments of all files on the disk called PR2: 
KA PR2/= 


To analyze disk space assignments for a group of files beginning with the letters, “PR” on the system disk, 
and a file called PR200 on a disk called PR2: 


KA PR= PR2/PR200 


To analyze available areas on the disk called PRBU: 
KA PRBU DSKAVL 
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5 


Output format: 


Six columns of information are output. The column headings, the format of the values these columns contain, 
and the significance of these values are as follows: 


HEADING VALUE SIGNIFICANCE 

AREA ADDRESS 8 digits Sector address of start 
6 hex. digits cf area 

AREA LENGTH | 8 digits Number of sectors in 
6 hexe digits this area 

STATUS 9 characters See Note 1 

FILE NAME 12 characters See Note 2 


Ta 
F iar 


i “Note 1: The status will be one of AVAILABLE, TEMPORARY, BAD, or *MISSING#, depending on 
{ whether the area is available, allocated to a file, denoted as temporary, unusable, or lost. 


“rena nena 
= 


Note 2: If the area is ASSIGNED, then this field will contain the identifier of the file residing in the area. 
If a file belongs to a pseudo disk its disk name is also listed. Otherwise it will be blank. 


i ~The status *MISSING* occurs if an area is not referenced from anywhere within the file directory or available 
, table-This may be because the area is in fact lost, or because existing files have been opened, have had further 
‘areas allocated to them and are still open during the processing of KA. 


If fixed disk is being used, three areas are reserved for MTR purposes with the status marked as “BAD’’. 
The area lengths are 256, 128, and 128 sectors respectively. 


Output messages: 


MES SAGE POSSIBLE CAUSES SUGGESTED ACTION 


*AREA APPARENTLY Area iS cortaineo KRotify field eng: 
ASSIGNED TWICE partly or comptete- ineering. DO NOT USE 

ly in an area prev- DISK. It may be possible 

iousty listed. to recover any file not 

| involved» usSirg COPY. 

*AREA ASSIGNED Area is assigned KRotify field eng> 
BEYOND MAXIMUM beyond the address” ineering. DO NOT 
ADDRESS* able space. USE CISK. 
NOTE: OUTPUT FILES Files were oren on KA printout may not 
ON DISK WERE OPEN disk white KA was be cometetely accm 
DURING THIS EXEC" processing. Other urate. Begin KA when 
UTION OF KA programs may have no other programs 

been in the mix ére in the mix. 

when KA was procs 

essing. 
input NOT FOUND IN Specified file is Check input and rem 
DIRECTORY ON THIS not on disk. input if necessary; 
DISK Check for correct 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


input NO FILES IN Group of files Check input and re- 
DIRECTORY FOR Specified 1s not Input 1f necessarys 
THIS FAMILY on diske Check for correct 

cisk. 


TABLE SIZE EXCEEDED Number of lines of None. 
output requirec is 

greater than KA 

permitse Maximum 

permittec is about 

141 pages of output. 

KA encse 


NO OUTPUT GENERATEC Disk directory cont” Check 

BY KA ains no file names cisks; 

to print.e Check Input ana 
re“input tf necessary. 


for correct 


Note: Refer to “Common Utility Output Messages” for additional aid. 
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KEY.CHECK 


This utility allows the operator to check and print the information on the ee OK is in an indexed pair 
of files. 


va 
~~ 


Format: ra 


KEY.CHECK aiceniaal keyfile-name | <BOTH oJ 


This utility does not provide the >¢<file name> option in the initiating message. 


During the execution of the utility the operator is informed if the data file has been updated via another 
key file or parity errors have occurred on the data file sincé creation of the specified key file. The checking 
is performed in two ways, Key file to Data file check, and Data file to Key file check. 


In Keyfile to Data file checking, the key value field of ‘eich entry in the key file are compared with the key 
_ field in the corresponding record of the data file. This comparison will detect any changes to the keys in the 
data file records and disused entries in the key al 


In Data file to Key file checking, the key field bi every non-deleted record in the data file will be checked 
to have an entry in the key file. The record written to the data file via another key file and records with invalid 
keys will be detected, as they will have no sie in the key file. 


If the <BOTH> option is specified in the ian message, then Key file to Data file and Data file to Key 
file will be checked otherwise only ney file to Data file will be checked. 


The utility will terminate if a parity error is encountered on the key file. 


If the Generation number of the Key file differs from that of the data file then a warning is printed. 
(Generation number is a field in the/ File Parameter Block, refer to MCP manual). 


The Generation number of the ies file will be modified to that of the associated data file on completion 
of a Key file to Data file check provided that the following conditions are satisfied: 


1. Every key entered in the key file matches the key field in the associated data file record. 

2. Every non-deleted data filé record has a key entry in the key file. 

3. The number of matched key entries in the key file 1s equal to the number of data file records with a key 
entry in the key file. Vs 

4. There are no parity errors on either the key file or the data file. 


Output Format: 
The output format is /self-explanatory. 


é 
£ 
; 
H 
Ss 


Examples: / 


KEY. CHECK POR 


Check the key file POR, performing Key file to Data file check only. 
KEY. CHECK POR <BOTH> 


~ Check the key file POR, performing Key file to Data file check as will as Data file to Key file check. 


} 
i 
é 


; 


Output Messages: 


POSSIBLE CAUSES 


ile~name IN USE 


file-name IS NOT A 
KEYFILE 


file-name IS A 
NULL@WKEY KEYFILE 


ilesname <DATAFILE> 
NOT FOUND 


fite~name <DATAFILE> 
IN USE 


ifile~name INCOMPATIBLE 
WITH KEYFILE 


READ ERROR GN KFPB 
OF file~name 


READ ERROR ON 
KEYFILE filename 
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The data file 


Another program 15 
using the keyfile 


Sel f-explanatory 


The specified file 
is a tag=file 


corresponding to 
the keyfile cannot 
be found 


The corresponding 
data file is being 
used by a progras 


The keyroffset olus 
keywlength in the 
KFPB of the specified 
keyfile is greater 
than the record size 
of the data file 


Parity errors have 
been encountered: 
the utility cannot 
continue. 


same as above 


SUGG:ST20 ACTION 


Wait until job using 
keyfile has closed 
file» then reminput 


Check the filename 


and rewinput 


See S$0G section on 
the SORT for meanings: 
this utility cannot 
check tagfiles 


C1)Enter LR disk-nane/ 
keyfile"name. 
(2) Check the disk name 
of the data file in 
LR listing. 

(3)1f the disk file 
name ts the same as 
the keyfile then 
copy data file from 
backup and reinput.e 
(4)1f the dis name 
is different then 
load that disk and 
re"minput. 


Wait until the other 
job has closed the 
data files then 
re~input 


none 


Ci) Attempt to copy 
files to another disk 
(2)Run CHECK.DISK to 
check the integrity 
of the disk 


same as above 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


UNABLE TG QPEN <KOTH> has been given none 
file-name <INDEXFILE> in the initiating 

message and the 

utility 1s unable to 

open the keyfile and 

datafile as an indexed 

pair after completion 

of the keyfile~to- 

datafile check 


Note: Refer to ‘““‘Common Utility Output Messages” for additional aid. — 
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KX (Disk Allocation Information) _ awe 
(a function of SYS-SUPERUTL) 


This function will allow the operator to display the name of the first file found on the disk ‘specified by “disk- 
name” (or on the system disk if no ‘“disk-name” is specified) whose total number of sectors allocated is equal 
to or greater than “number” (assumed zero if not specified). 


KX | disk-name | number 


_ After each display, which will include the information of the current numbers of temporary and available sec- 
tors, the KX function of SYS-SUPERUTL remains available, waiting for one of the following input responses: 


Format: . 


A call on any other function of SYS-SUPERUTL: this will terminate KX. 

KX or KX NEXT To display the next file name, if any, otherwise KX will go to END. 
KX RM or KX REMOVE To remove the file whose name has just been displayed. 
KX END To terminate KX. - 


Examples: 


To display th € cs n ame O sen efi BO oe: ens Be OL Ste ater u than 250 sectors: 


phat 


To display the name of the next file whose size is equal to or greater than 250 sectors: 


KX NEXT 
To remove the file just displayed: 
KX RM 
To terminate KX: 
| KX END 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


KX success ful 


filename - ntmber Normal KA display. 
SECTCRSs AV. number» showing current 
TEMP Cor TEMPORARY) number of sectors» 
number available anc 
temporary on 
disk. 


input IS AN UNACCEPT>= Typing error. Check input and 
1ABLE RESPONSE FOR KX | re"“ertere 


See SYS-SUPERUTL messages also. 
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LB (Look Back in Log) 


(a function of SYS-SUPERUTL) 
This function will Look Back to continue recall in the direction of earlier messages with a screenful of mes- 


sages. If the serial printer (SPA) is used as the console, then the function will display a number of messages 
calculated by the length of messages and width of console. 


Format: 
LB 


Example: 


To look back and display the messages: 
LB | 


LB can be initiated only after IR, LB, and LF. 


Output messages 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


IR REQUIRED BEFORE IR function was not Initiate IR then 
{8 CAN BE OONE initiated before LA. remirout LB. 


CANNOT RECALL LB LB has reached the 
BEYOND THIS POINT becinning of this 
log file 


eS # 
a) ; 

A i 2 
# 


LD (Tape Library Utility) 


This utility allows the operator to maintain library tapes. It is divided into the ‘sllowns four separate “‘sub- 
programs” (functions): 


ADD (tape-to-disk file copy) 

LOAD (tape-to-disk file copy; duplicates are removed from disk) 

DUMP (disk-to-tape file copy) 

UNLOAD (disk-to-tape file copy; files are deleted from disk 
after being copied to tape) 


On the B 80 these four functions can be invoked directly: the MCP will recognize that they are part of the 
LD program and load LD from the system disk, passing LD the appropriate information. For example, the input 


DUMP TO ARTAPE AR= causes the same action as 
LD DUMP TO ARTAPE AR= 


If LD does not reside on the system disk, the user-disk name and ‘LD” must be specified. 


Should the operator request a “‘mix message”’ (see MIX intrinsic) while any of the 4 functions are running, 
“LD” (not the name of the specific function) will appear in the mix. 


Similarly, to discontinue any of the four functions, a message of: “DS mix number/LD” will be required. 


Detailed descriptions of ADD LOAD, DUMP, dnd UNLOAD and associated output messages are provided 
under the name of the function. / 


meen ccstiumere one me poms 
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A\ 


LF (Look Forward in Log) 


(a function of SYS-SUPERUTL) 
This function will look forward to continue recall in the direction of later messages with a screenful of mes- 


sages. If the serial printer (SPA) is used as the console, then the function will display a number of messages 
calculated by the length of the messages and the width of the console. 


Format: 
LF 


Example: 


To look forward from last recall and display messages: 
LF 


LF can. be initiated only after IR, LB, and LF. 


Output messages 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION. : 


IR REQUIRED BEFORE IR was not initiated Initiate IR and then | 
LF CAN BE DONE before LF rewenter LF | 


CANNOT RECALL LF LF has disptayed the None 
BEYGND THIS POINT most recent entry in 
the log file 
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LIST (File List) 


This utility allows the operator to list in whole or in part files on any CMS device. Output will be either 
to the line printer or to the console printer. 


Format: 


starting number of 
A record records 
<KEY> number to list 


If the “A” option is chosen the file will be listed in alpha characters. The “N’’ option will list the file entirely 


in hexadecimal. If neither the “A” nor “‘N” options are selected, the file will be listed in both alpha and 
hexadecimal. 


If the file to be listed is a keyfile, the utility will list the associated data file in the order of the keyfile unless 
the <KEY> option is specified. When the <KEY> option is used, the utility will list the keyfile itself. 


The operator may also list selected parts of a file by specifying the relative record number at which printing 
should begin and the number of records to be printed from that point. 


Examples: 


To list the records of a file called PROGSRC as alpha: 
LIST PROGSRC A 


To print the first record only of a file called PR200 in hexadecimal: 
LIST PR200 N 1 1 


To list records 100 through 149 of PROGSRC as alpha: 
LIST PROGSRC A 100 50 


To List Keyfiles: 


Assume there is a keyfile called PR200K which refers to a data file called PR200. 


The statement 
LIST PR200K N <KEY> will list all records of the keyfile PR200K in hexadecimal. 


The statement 7 
LIST PR200K N will list all records of the data file, PR200 in keyfile order in hexadecimal. 


Additional Capabilities 


Further features of this utility are summarized in the railroad chart given in Figure 4-3, which gives the com- 
plete input specifications. 


Non-disk files 
Files on media other than disk may be listed. Abbreviations for valid devices are as follows: 
MTP —- magnetic tape or cassette 


CRD - punched cards 
PTP — paper tape 
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“~agarane 


* < file-name > 


— LIST 
< r-spec > 


< f-spec > 


< f-spec > is defined as : 


A 
1 
N 
MTP 
PTP 
1 CRD 
< file-name > 
1 EBCDIC 
| RECORD Sr > 
1 BLOCK -————— <bs> 
1 TAPE.MARKS SS hi 
1 NO.LABEL 


1 KEY > 


— 


<r-spec > is defined as : 


a ee 


< r-count> 


< record-key> 
— <record-key > 


Figure 4-3. Railroad Chart for List Utility 
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Examples: 


To list a cardfile called PRFILE in alpha: 
LIST PRFILE CRD’A 


To list the first 10 records of a CMS labelled magnetic tape called PRTAPE: 
LIST PRTAPE MTP 1 10. 


(Note: this assumes record size of. 180 bytes). The tape or cassette to be listed should be a tape created by the COPY 
utility. Library tapes and non-CMS tapes should be treated as unlabelled (see below). 


Unlabelled tapes 

Input tapes having no CMS labels (“unlabelled’’ tapes) may be accessed by the LIST utility. 

The NO.LABEL option allows the listing of unlabelled files. Upon recognizing an unlabelled file, the MCP 
will print a “DEVICE REQUIRED” message. The operator must then respond with an appropriate “AD” in- 
put message (see “AD”) to identify the unlabelled file. 

The end of file recognition for unlabelled files is determined by tapemark count. The TAPE.MARKS option 
allows the operator to specify the total number of tapemarks which will indicate end of file to the utility when 
listing an unlabelled file. The default value is 2. Each tape mark which is encountered will contribute to this 
total. Therefore, a standard labelled CMS file will be listed up to, but excluding, the trailing label if NO.LABEL 
and 2 tapemarks are specified. (A labelled CMS file consists of “Label, Tape mark, data, tape mark, label‘). 
The operator must be aware of the format of any file which is to be listed when using the NO.LABEL option. 

If the RECORD size is not 180 bytes, refer to the section on Record/Block modifications. 

Example: 


To list the first file of a magnetic tape with non-standard label (the format being: label, tapemark, data, tape- 
mark): 


LIST TP MTP NO.LABEL TAPE.MARKS 2 


Note: MCP will issue a message asking for unlabelled tape TP. Operator must respond with “AD” eee 
_ Additionally, the first line of the listing contains a list of the non-standard label. 


Record and block sizes 

The listing is record-oriented. The following record sizes are assumed: 
Disk = (Disk File Header) from file itself 

Labelled tape/cassette = from tape label 

Unlabelled tape = 180 bytes 

Cards = 80 or 96 bytes depending on device. 

If different values are required Record and Block sizes may be specified. 
Example: 


To list an unlabelled tape containing 10-byte records with 10 records per block: 
LIST TP MIP NO.LABEL TAPEMARKS 2 
RECORD 100 BLOCK 1000 


If EBCDIC is specified, the input will be translated from EBCDIC coding, otherwise ASCII is assumed. 
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For magnetic tape or cassette files the record size must be specified if it is greater than 1024 characters, other- 
wise the utility will not be able to read this file and therefore no list will be produced. If the record size is 
specified and no block size is specified then the block size will be set to the same as the record size. For unla- 
belled files the default record and block sizes are 180 each. 


Note: Care should be taken to ensure that the record and block sizes specified are compatible with the 
physical block size on the tape. The block size specified must be an integer multiple of the record size. The 
utility will attempt to identify inconsistencies when using labelled CMS files. Any inconsistency not isolated by 
the LIST will cause MCP to discontinue (DS/DP) the utility. 


Selected file list 
More than one selected portion of the input file may be listed. Pairs of numbers may be specified within 


each pair the first number specifies a relative record number and the second specifies number of records to 
be listed. If an extra number is specified the last number specifies listing from that record to the end of file. 


Example: 


To list records 100 to 149, 300 to 499, and 1000 to end of file. 
LIST FILE1 100 50 300 200 1000 


Selected indexed file list 


_ For indexed files, listing of records can be selected based on content of the key. There are 2 options: the 
number of records can be specified or an ending key value. 


Examples: 


PQR is a keyfile containing personnel records. To list 15 records from the corresponding data file starting 
from the record with personnel number 01786: 


LIST POR 01786 15 


Using same keyfile to list all data records from personnel number 01786 to 18000: 
LIST POR 01786 — 18000 


Note: the second option is specified by the hyphen in the LIST statement. Note that at least one space is 
required before and after all key values (personnel numbers in this case). 


Output messages: 


MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


number number IN Error found tn pair Check input anc 
filename NOT LISTED of numbers for set- re"enteér. 

ected record list | 

option- Une record 

number in the pair 

indicates a seCtion 

of the file at a 

lower 

file address than a 

previously specified 

Section. This pair 

is ignored by LIST. 
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SSAGE —« POSSIBLECAUSES SUGGESTED ACTION 


filename EXHAUSTED Endrof"file was Check input and 
DURING number | encountered while the re-erter if necessary. 
number sectior of the file | 
indicated was being 
copiede 


filename EXHAUSTED  Endtof7*fitle encount™ Check input and 
DURING RANGE ered while section of remerter if necessary.| 
recordkey record file indicated is | 
key being listed? or no 


or records were found 
filename EXHAUSTED in range of the 2 
DURING RANGE record keys. 


record key number 


NO RECORDS FOR Specified file cont” Check for correct 
LISTING FROM ains no records to file-néme. 
filename fiste | 


filename NOT ACCEPT- LIST has encounter Check input and 
ABLE - RECORD SIZE ed a file witin a. reenter. 

OF number EXCEEDS record size great- 
MAXIMUM FOR THIS er than expected. 

RUN ~ RESUBMIT This can happen if 

| a Magnetic tape file 
with a record size 
greater than 1024 
chéracters is 
submitted to the 
utility without the 
record size being 
properly specified 

in the initial input. 


Check for correct 
mediums 


KEYFILE file-name OR Utility cannnot tocate 
‘DATA FILE NOT FOUND keyfile or data file 

! pertaining to the 
keyfile specif ications. 


BAD ATIYRIBUTE The number specified Correct the ingut 
SPECIFIED after BLOCK is not an and re~input. 
integer multiple of the 
number specified after 
RECCRD. 


PERMANENT ERROR ON The irrecoverable 
INPUT FILE fite-~ errors @ege parity 


name (NOw. number or error has been founds 
KEY key) 
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MESSAGE | PCSSIBLE CAUSES SUGGESTED ACTION 


SELECTIONS OF RECORDS The file reached end 
FROM number IGNORED tefore the record 
selected. 


RECORD SIZE FOO GREAT The specified record 
size is greater than 
10000. 


INVALID CHAR. IN A tape with an illegal Correct the name 
IDENTIFIER filename - naeme is specifiece and re input. 


WARNING 
KEYFILE filename OR The specified keyfile Wait until the task 
DATA FILE IN USE and its data fite are using keyfile or 
on lines but one or data file goes to 
toth are in use by a end of jcbe 


task which will not 
permit sharing. 


Note: Refer to “Common Utility Output Messages” for additional aid. 
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LOAD (Load Library Tape Files to Disk) 


. This function, a part of the LD utility, allows the operator to copy files from a library tape to disk. As files 
are copied to disk, any duplicate files will be automatically removed from disk by the function. 


Format: 


| LD LOAD FROM library-tape-name | TO disk-name 
file-name or 
group-name < BOTH> | 


_ If the <BOTH> option is used immediately after a request to copy a keyfile, the associated data file will 
also be copied, provided that the data file does not precede the keyfile on the library tape. The keyfile will 
be altered to refer to the disk which now holds the data file (rather than the disk from which the data file 
was dumped). | | - 


Examples: 


To copy all files from a tape called PRTAPE to a system disk: 
LOAD FROM PRTAPE = 


To copy the file called AR300 from a tape called ARTAPE to a disk called ARBU: 
LOAD FROM ARTAPE TO PRBU AR300 


To copy files called DCSTSK, and PRTASK from a tape called PRTAPE 
LD LOAD FROM PRTAPE DCSTSK PRTASK 
To copy from a tape called PRTAPE the keyfile called PR200K and its associated data file to the system 
disk: : | | | | 
LOAD FROM PRTAPE PR200K <BOTH> — 


Since “LOAD” is a part of the utility “LD”, “LD” is actually what will appear in a mix message. To discon- 
tinue the LOAD function, “DS mix number/LD”’. | | 


Output messages: | 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


|file-name LOADED LOAD success ful 
file-name REMOVED LOAD successful: 

original file on 
disk was removed. 


Tape does not have | Frovide utility with 
a recognizable correct tape» 
header. DS the LD utitity 


library" tape“name 
NOT A RECOGNIZED 
DUMP TAPE 
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MESSAGE 


NO FILES IN THE 
FAMILY qroup“name 
ON TAPE tibrary- 
tape"name FOR LOAD 


NO FILE file-name 
ON TAPE tibrary” 
tape-name FOR LOAD 


file-name LOAD/DUMP 


DISCREPANCY 


NO FILES TO LOAD 


filename DATA FILE 
NOT FOUND ON TAPE 
FOR LOAD 


POSSIBLE CAUSES 


Specified group 
was not found on 
disk. 


Specified file was 
not found on tape. 


End of File ence@unt- 
ered before expected. 


Disk File Header 
may contain errors. 


No fites were found 
on this tape to 
COPY. 


Data file for this 
keyfite does not 
follow on tape. It 
cannot be copied. 
Keyfile was copied. 


SUGGESTED ACTION 


Check input ard 
remerter if necessary; 
Check for correct 
tape. 


Check tnput and 
reenter if necessary, 
Check for correct 
tace. 


Check input and 
reenter if necessary? 
Check for correct 
tape. 


Check if data file 
apoeéers before key file 
cn taoe Cuse TAPEPD); 

if so» Load full tape to 
cisk. 


Note: Refer to ‘““Common Utility Output Messages” for additional messages. 
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LOAD.VFU (Load Vertical Format Unit) 


This utility allows the operator to define the page format on a line printer that contains a soft vertical format 
unit. 


Format: 


DEFINE  format-name antec , Number-2 da number number | 
or 


FORMAT LPx WITH format-name 


LOAD. VFU or 
LIST ALL | format-name y 
or 


DELETE format-name 


The utility may be used to define vertical format unit formats and store them in a library file SYSVFU.LIB. 
These formats can be subsequently selected by name to be loaded to the specified printer (type A 9249-30/50). 
The utility zips the VF intrinsic which performs the actual loading of a format string. 


When using the DEFINE function, if the file SYSVFU.LIB does not already exist, the utility will create this 
file and an entry will be made for the format being defined. Otherwise, the file will be updated to contain the 
newly defined format. The number-1 is the page height in lines and number-2 is the end of page line. The pair 


of numbers consists of a channel number (2-11) followed by a ‘skip to line’ number (not greater than the page 
height). 


Example: 
LOAD.VFU DEFINE PAYROLL 66, 60, 2 10, 4 20 


This format is equivalent to: 


Page Height = 66 
End of Page = 60 
Channel 2 has associated line number 10 
Channel 4 has associated line number 20 


This format is also equivalent to figure 4-4, which illustrates a paper vertical format tape on other line print- 
ers. 


BURROUGHS CORPORATION PART No. 10020717 


PLACE CYTOFF EDGE :OF TAPE HERE—e» 
ol A RS Oe ah J Pode pe ee ele ie ote te Pee pe ed ep ee ee ee id ee 
eel a ok ote chee fe est 2 Wee deed Petts pee de eee ie th a ae i ee eh ee 
Es SR ES ee a Se ee P| eda (od oe cd ls 1 he hee bal ob hc pei [en [ee Peed Pep eh Pde oe ad A 
i Se ee ee ee 5 Po be ee ee ol ad oe od a Pee ee ee de hs Sr 
tel eh oh ee AO ett ek he 
SAS A is i in epee a cls Rs Dn ea en cis Bs RUS GEN GB IN cB Dc ls A SI cB eB ts Bly oN hs a Ss in NC inc NS a Dn cB ln ns 
1 ak A eS A Ces) ek Lae AG A Ha “> Sa ae A A Cas ee (ME ey ea ee DG DS Hs a ae ee a ae ae a ee ee 
ee ee eS es ae es ee : FSR aoe (7 Gs Re CS Pe sea 2 A (EA Le Rad GR RE LR WN CSL a eae ag my (Ge SE GE AE ET ST A ee 
ede iba fae Vie Pode ds ates ele oh ae ht 10 Fs Sara FF ae et ae (aS eR ed ae Se | | ptf ft ft ft tt ff ttt tt 
Be Se ee ee ee ee ee Se Se ee 1] itis tet TE TE EE TEC Ed 1 Ce eS 
Poh fe bs. pe ps ee I ee es Ee | 12 Lt ivint TT tT tT tT ct Eh ThE hE huE hcdE Tl hud ht hc a i} BHLlip See eee ewe eee 
66 656463 62 61 60 59 58 57 56 55 54 53 52 51 5049 48.47 46 45 44 43.4241 40 39 38 37 36 35-34 33 32 31 30 29 28 27 26 25 24 23 22 21 2019 1817 16 16 14131211109 8 76543218 


Figure 4-4, Paper Vertical Format Tape 
Limitations: 


The utility does not check the following: 


1. For each channel, no more than 4 line numbers can be specified. 
2. Page height defined should not be greater than 94 lines. 


The FORMAT function allows the operator to load a predefined VFU format to a specified printer. The 
printer must be ON LINE and NOT IN USE. 
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Example: 


To load the format PAYROLL defined earlier on LPA: 
LOAD: VFU FORMAT LPA WITH PAYROLL 


The LIST function has three possible options: 


LOAD.VFU LIST 


will list all format-names defined in SYSVFU.LIB; 


LOAD.VFU LIST format-name 
will list the format string of specified format-name as defined in SYSVFU.LIB; 


LOAD.VFU LIST ALL 
will list all format-ids and strings as defined in SYSVEU. LIB. 


The DELETE function is used to delete a predefined VFU format from the SYSVFU.LIB file. If the format 
being deleted is the only defined format in SYSVFU.LIB, then the SYSVFU.LIB file will be removed. 


Example: 


To delete predefined VFU format PAYROLL from the SYSVFU.LIB file: 
LOAD.VFU DELETE PAYROLL 


NOTE: The default values of page height and end of page are 66 and 60 respectively. Non-default values 
require that the format should be loaded prior to the execution of the program. 


Output Messages: 


SYSVFU.sLIB NOT FOUND 
ISYSVFUsLIB IN USE 
READ ERROR ON 


SYSVFU.LIB 


WRITE ERROR ON 
SYSVFU.LIB 


formatename NOT FOUND 
IN SYSVFU.LIB 


ilformat=name ALREADY 
DEFINED IN SYSVFU.LIB 


format-name DEFINED 
IN SYSVFU.-LIB 


format~name DELETED 
FROM SYSVFU.LIB 


4-16 


POSSIBLE CAUSES 


Self-explanatory 


Another copy of 
LOAD.~VFU 1s running 


Parity error on 
the Library file 


Parity error on 
the library file 


Requested DELETEs 
FORMAT or LIST cannot 
find speci fied 
format7™name 


Cannot DEFINE two 
formats of the same 
name 


DEFINE function has 
been successful 


DELETE function 
been success ful 


SUGGZST=2D ACTION 


Use DE-INE function 
to create library file 


Use only one copy of 
the utility 


Check input and 
rementer if necessary: 
use De-INE function to 
create format “name 


Rewminput using 
different format™name 


MESSAGE POSSIBLE CAUSES «SUGGESTED ACTION 


SYSVFU.-LIB DELETED A DELETE function 
has deleted the only 
remaining format 
in the library files 
and the fite has been 
removed 


peripheral FORMAT function has none 
FORMATTED WITH been success ful : 
format-™name 


PRINTER peripheral The utility has found refer to the VF 


NOT FORMATTED WITH the specified format error message 
format-name in the library» but 


the zip of the VF 
intrinsic was — 
unsuccessful (this 
will be preceded by 
output from VF) 


a 


LE 
* ‘@: 
Novy, 
aires 
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LR (List Directory) 


This utility allows the operator to print detailed information about particular files or groups of files on disk. 

If a file has areas on an associated overflow disk, then the disk name of the overflow disk is printed beside 
each relevant area address and size. Note that the addresses for the areas on an overflow disk are not necessarily 
correct. 


If a particular file or group is not found on a specified disk, this is indicated on the listing. 


If “<ASCENDING>” or “<A>” 1s selected, the utility will print the information requested in ascending 
order of file-names. | 


If “number” is specified after the LR of an entire disk (that is, LR ARDISK2/=), then LR will only print 
information about those files whose total number of sectors allocated is greater than “‘number'‘; this will be fol- 
lowed by a listing, with totals, of all available and temporary areas on the disk. 


An output line concerning a keyfile will normally be followed by a second line showing the name of the data 
file to which this keyfile points and the key offset and length. 


The heading lines printed at the top of each page will provide a good deal of information about the disk 
itself. 


Format: 


file-name or <A> or | | 
LR disk-name / group-name < ASCENDING > number 


Examples: 


To print the entire directory of the system disk: 
LR = 


To print the entire directory of ARDISK2 in ascending order: 
LR ARDISK2/= <A> 


To print information about the file called ““AR200” and a group of files beginning with the letter “C” only: 
LR C=, AR200 


To print information only about files on the system disk which have been allocated greater than 1000 sectors: 
LR = 1000 


Output format: 
Fourteen columns of information will be output to the printer for each disk for which information is re- 


quested. The column headings, the format of the values these columns contain, and the significance of these 
values are as follows: | 
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HEADING VALUE SIGNIFICANCE 

FILE NAME 12 Characters | File néme 

ACTUAL SIZE ? digits Number of records 
currently contained 

| in file | 

MAXIMUM SIZE ? digits Maximum number of 
records which file may 
Contéin 

RECORD SIZE 5 digits Number of bytes per 
record 

RECORDS BLOCK 5 digits Number of records in 
each block 

CREATED 5 digits File creation date 
(Julian YYDOD) 

ACCESSED 5 digits Last access date 
(Julian YYDDD) 

FILE TYPE 8 characters See Note 1 

NO. AREAS 2 cigits Number of areas 
Currently eatitoc- 
ated 

AREA ADDRESSES 8 digits see Note 2 

6 hex. characters 
AREA SIZES 8 digits See Note 2? 
6 hex. characters 
OVERFLOW DISK ? characters Name of overflow disk 


Blank if not an 
overflow area 


Note 1: The FILE TYPE will be one. of the following: 
DATA — normal data file 
SRCELANG -— source language file 
SRCELIBR - source library file 
CODE - object code file, followed by compilation date 
(YYDDD) 
KEY - key file 
SYSTEM - system file (for example, MCP,interpreters) 


Note 2: For each file the area addresses and sizes of allocated areas will be printed in these columns. For 
areas on an overflow disk the overflow disk name will follow the size. | 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACT YON 


The number of file- 
EXCEEDED names to be sorted 
by LR in an ASCEND@ 
ING or A request has 
exceeded the maximum 
permitted (254). 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


input - NOT FOUND Fite specified is Check the correct 
IN OIRECTORY OF | not on the disk cisk and reenter 
ITHIS DISK if necessary 


input = NO FILES IN Group of files Check tnput and 
DIRECTORY FOR Specified 185 not on rementer if necessary. 


THIS FAMILY disk 


Check for correct disk. 


Note: Refer to “Common Utility Output Messages” for additional aid. 


MODIFY (Program Code File Modification) 


This utility allows the changing of a number of file attributes within the file parameter block (FPB) and pro- 
gram attributes within the program parameter block (PPB) of a code file. It should not be used unless the mean- 
ing of each attribute is thoroughly understood. Refer to the CMS MCP manual for more information on FPB 
and PPB formats. 


The utility operates in an interactive manner using a console file if no further information is provided when 
initating the utility, thus: 


MODIFY 


For details of the interactive mode, see later. Specifications can be entered when starting the utility. The name 
of the code file to be modified is preceded by the keyword ““CODE.FILE”’. The word “CODE.FILE” can be 
omitted from the first element of the initiating message. Following the code file name is either the keyword 
“FILE” to enable file attributes to be modified, or the keyword ““PPB” to enable program attributes to be 
changed. The file whose attributes are to be changed is specified by the internal file name (i-f-n) as given by 
the program source code listing. The i-f-n is determined by the programmer. Additional keywords are “‘PRIN- 
T.FPB” and “PRINT.PPB” to print the complete FPB and PPB respectively. The complete specifications to 
the utility are terminated by the keyword “END”. 


Format: 


MODIFY CODE.FILE | disk-name / program-name 


FILE i-f-n file-attribute value 
PRINT.FPB 
END 
PPB ppb-attribute value 
PRINT.PPB 


The commas are optional, but may be used to improve readability. See later for the list of attributes and 
allowable values. 


Examples: 


To modify the value of FID (file-id) and change the device kind of a file whose internal name is INFILE 
in a program code file COPY on disk SYS2: 


MODIFY CODE.FILE SYS2/CCPY, FILE INFILE FID CARDS DEVICE CR, END | 


To change the value of CONTROL.STACK to 50 in code file AR768 on disk AR1, and print the resultant 
PPB: | 
| MODIFY AR1/AR768 CONTROL.STACK 50 PRINT.PPB END 
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Interactive Mode 


If no initiating specifications are given, PKs 1 to 6 are lit for various functions. 


modify 
PPB 


Pressing PK1 gives a display of the meanings of the 6 PKs, as shown above, followed by the request 
CODE.FILE? 


Enter the code file name, followed by OCK1. The utility requests 
SELECT FUNCTION 


and lights appropriate PKs. While any relevent PK is lit, the corresponding function can be started. 


If PK2 (modify PPB) or PK3 (FPB) is depressed, the utility requests 
PPB ATTRIBUTE or 
FPB ATTRIBUTE 


Enter the name of the attribute, as given in the table later. The utility displays the current value, then re- 
quests 


NEW VALUE. 


Enter the new value required. The utility then returns to the select-function loop. 
File Attributes 


Table 4-2 gives the keywords for each file attribute that can be changed by the MODIFY utility, together 
with allowable values for each attribute. Table 4-3 gives the keywords of each PPB attribute that can be 
changed, and allowable values for each. 


Note that each modification is performed in turn, so that the keywords PRINT.FPB and PRINT.PPB will 
reflect the FPB and PPB after any modifications specified previously in the message to MODIFY, but before 
any modifications are made that are specified after the print request. 


Output messages: 
MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ATTRIBUTE VALUE Value is either Check current values 
MISSING missng or incorrects ty PRINT.FPB or 

other wodifications PRINT.PPB; then use 

carried out. utility for the attr: 

Ibute In error. 


KEYWORD IN ERROR Selfr-explanatory>, As above. 
other modifications 
carried 
ATTRIBUTE“VAL The attribute being As above. 
INCONSISTENT assigned cannot take 
the value being 
given; other mod- 
ifications carried 
out 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


INCORRECT ATTRIBUTE A value 1s being As above. 
assigned to a value» 
rather than to 4an 
attributes other mod- 
ificatitons carried 
out. 


DEVICE = MYUSE Incompatible values Use MOCIFY to correct 
INCONSISTENT of these file attri either or both of 
butes. This is a these fields. 
warning that the 
prooram may give an 
error when executec. 


FILE“SIZE Too Value for FILE.SIZE Check with PRINT.FPB 
LARGE is tincorrect- This if necessary and correct 
is a warning. the éttribute. 


TOO MANY RUFFERS 


Value for NO -BUFFERS 
1S tncorrect. This 1s 
a warning. 


REC. NOT INTEGRAL The buffer size is not Use MOCIFY to correct 
OF BUF. an exact multiple of one or both of these 
the record sizee This ettribtutes before 

is a warning. running program. 


CODE FILE NAWE IN Selfrexptlanatory? 
ERROR atl modifications 
are tonorede 


Reinput « 


FILE NAME NOT FOUND As above. 


The internal file 
name iS not In coce 
filer att modificn- 


ations are tqnored. 


CURRENCY SYMBOL 
EXPECTED 


Self explanatory Re~irptut. 


‘NUMERIC ATTRIBUTE ° Non*numeric char” Check with tables 

VAL REQO acters were Input 4.2 éenc 4.3. and 
| where a numeric remirout. 

value is needed. 


FILE NOT SPECIFIED Missing keyword Retinput - 
Pr ILe* 


PPB NOT SPECIFIED Attempt to modify Re- input. 
PPB while not in 


| PPB mode. 
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NOT AN INDEXED 
FILE 


NOT A COBOL PROGRAM 
FILE 


NOT AN MPL PROGRAM 
FILE 


CODE FILE = BAD FILE 
TYPE 


CODE FILE IN USE 


CANNOT OPEN THAT 
CODE FILE 


NUMBER TO0 SIG 


MUST HAVE OQ < KEY 
LENGTH < 29 
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POSSIBLE CAUSES 


Attempecd to use an 
indexedfile attric- 
bute on a nonminc@ 
exed file. 


Wrong PPE attribute 
used (see table) 


Wrong PPE attribute 
used (see tabie) 


Attempted to modify 
a code file wich was 
not of type COCE. 


The specifiec code 
file is in usee 


Attempted to modify 


a code file which was 


not avaiiable for 
some reasone 


Attempted to assign 
a value greater than 


Attempted to assign a 


KEY LENGYH value cut 
of range. 


SUGGESTED ACTION 


Check initial 
input to MODIFY 


Re~input.e 


Wait until the task 
using code file coes 
to end of job.e 


Nonee 


Nonee 


file attribute 
name 


MFID 

FID 

REEL 

DEVICE 
RECORD 
BUFFER 
FILESIZE 
NOeBUFFERS 
CYCLE 

FORMS 
SETeUPDATE 
NO eLABEL 
CONDITIONAL 
SINGLEAREA 
GEN CHECK 
NO«#REWIND 
REVERSE -CHECK 
CLOSEMODE 
CRUNCH 
MERGE 
OTHERUSE 
MYUSE 
EXTEND 
ACCESSMODE 
GEN.NQO 
LAST.ACCESS 


SAVE 
FILE»DEFAULT 


NONe STANDARD 
DeMFID 


DeF ID 
ROUGH. TABLE 
KEY »LENGTH 


KEY OFFSET 
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Table 4—2. File Attributes Accessible by Modify 


allowable values 


i-/” alphanumeric characters 

1°12 alphanumeric characters 

3 decimal cigits in range 0007999 

one of the mnemonics given in Table 4-4 
i-5 decimal digits in range 0765535 
1-5 decimal digits in range 0°65535 
1-7 decimal cigits in range 071048560 
1-2 decimat digits itn range 1°16 

2 decimal digits in range 90°99 

ON» OFF 

ON» OFF 

Ci» CFF 

CN\» OFF 

CN» OFF 

CN» OFF 

CN» OFF 

ON» OFF 

LOCK» PURGE» REMOVE» RELEASE» HALF.CLOSE 
GN» OFF 

CN» OFF 

FREE» LOCK.ACCESS» LOCKED or SHARED 
INPUT» CUTPUT» I0 

CN» OFF 

SEQUENTIAL» STREAM» RANDOM 

1-5 decimal digits in range 0765535 

5 decimal digits in Julian date formats 
YYDOD | 

1-3 decimal digits tn range 07999 
TYPEL theu TYPE29 (see MPL Reference 
Manual ) 

ON» OFF 

1-7 alphanumeric characters Cindexed 
files only) 

1°12 alphanumeric characters Cindexed 
files only) 

i-5 decimal digits in range 0765535 
Cindexed fites onty) 

1-2 decimal digits tn range 17°28 
Cindexed fides onty) 

1-5 decimal digits tn range 0765535 
Cindexed fides only) 
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Table 4—3. PPB Attributes Accessible by Modify 


| PPB attribute allowable vatues 
name 


INTERP.PACK 1-7 alphanumeric characters 

INTERPeNAME 1712 alohanumeric characters 

CLASS | A» Bs C 

EN0J-SUPPRESS ON» OFF 

DATA.STACK 1-5 decimat digits in range 0765535 
(MPL/BIL programs only) 


CONTROL.STACK 1-5 decimat digits tn range 0765535 
CURRENCY.~SYMBCL one character (CCBOL/RFG programs 
onty) 


Table 4—4. Mnemonics for Device Attribute for Modify 


mnemonics meaning 


PR any printer 

KP keyboard printer 

KD keyboard display 

KB keyboard any output 

sP serial printer 

LP | Line printer 

CR any card reader 

cp any card punch 

CRP any card reader/punch 

CRBO 80-cotumn card reader 

CP80 8O0-coltumn card punch 

CRP8O0 8O07colLumn card reader /punch 
CRI6 96-colunmn card reader 

CP 96 96-coflumn card punch 

CRP96 96°column card reader/punch 
PTR Paper tape reader 

PTp paper tape punch 

MT Magnetic tape reel or cassette 
MT9 magnetic tape reet 

CS Magnetic tape casSette 

MT9IN magnetic tape reel without write permit 
CSIN magnetic tade cassette withott write permit 
DC any cisk 

DM Any miniédisk 


PB (List Printer Backup files) 


This utility allows the operator to list printer backup files. The utility has two formats. 


Format 1 


| intone VA cake 1 ee | Vv | V 
PB | disk-name PBNNNNN SAVE COPIES number ON device-type 


Format 2 


a disk-name/= V COPIES number J | ON device type i) 


The options can be entered in any order. 


The printer backup files have the identity of “‘PB” as the first two characters of their name and file type 
value ‘““AO” (see the MCP manual for file types). 


To print a printer backup file PBOO011 from the system disk: 


PB 11 
PB PBOO011 


If the option SAVE is used then the backup file will be retained after printing. If the option is not used 
then the file is removed from the disk after printing. 


The option COPIES followed by a number specifies the number of copies to be printed, between | and 99. 
The default value of ’number’ is 1. 


The option ON allows the operator to specify the type of printer that will be used to print the file. If used, 
this option will override the device type specified when the file was created. 


Examples: 


To list a printer backup file PB00100 from a disk PRDISK on serial printer and save after printing: 
PB PRDISK/PBO00100 SAVE ON SP | 


To list 5 copies of a backup file PBO0101 and remove after printing: 
PB 101 COPIES 5 


To list 2 copies of all the printer backup files from a disk ARDISK and remove after printing: 
PB ARDISK/= COPIES 2 


Output Format: 

The first page of the output listing will contain a banner type heading. The heading will contain Time, Date, 
Program-name, which created printer backup file, and backup file name taken from the first record of printer 
backup file. 


If the special forms fit is set, a field in the File Parameter Block (see MCP manual) which is set 
programmatically, then the heading is not printed for that file. 


If the special forms bit is set, then the utility will display a message and wait on accept: 
SPECIAL FORMS REQUIRED FOR printer backup filename CREATED BY program name 
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The operator should enter “Y” or ‘“‘N” to the ACPT message to print or not to print the file. 


After printing the file requiring special forms, a message is displayed to inform the operator to reset forms: 
REMOVE SPECIAL FORMS 
and the utility will wait on accept. The response should be 
AX mix number OK 


At the end of the special forms job, the printer is closed with a lock. 


Output Messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


INVALID FILE The file specified to 

FORMAT IN be printed by the 

file-name utality is not a 
printer backup file. 


ABNORMAL The PB file number found 
TERMINATION at the beginning of each 
FOR file-name data record does not 
match the PB fite number 
found in the identification 
record of the PB fite 
(first record). 
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PD (Print Disk Directory) 
(a function of SYS-SUPERUTL) 


This utility allows the operator to verify the presence on disk of a particular file or a group of files. 


| | | file-name or 
PD disk-name / group-name 


Format: 


Examples: 


To find out if a particular file is on disk: 
PD PR210 
PD PR2/PR020 


To find out if a group of files is on disk: 
PD PR2/PRO= 
PD PR3= 


To find out if several different files or groups are on disk: 
PD PR3= . PR2= 
PD GL2GLO= , GL2/GL30= , GL250 


£ 


To inquire about all files on disk: © a 
aa Do Ai aoe DP ¥ = 
PD= Nete tetera: v Cae ik rUp: 
PD PR2/= 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


ON LINE program File found on disk 
name if single fite reaq- 
uested. 


group"name ON disk- Group of files found None. 
name CONTAINS: on disk 


NOT ON LINE File not found on Check input Creinput 
program™name disk if necessary)» 
Check for correct 
cisk. 


INO FILES FOUND IN Group not found on Check input Cre~input 

THE FAMILY “group~ disk. : if necessary ) » 

name” Check for corfect 
cisk. 
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MESSAGE POSSIBLE CAUSES _ 


JEND PD Successful End of 
Jobe 


"fi Lle"namhe™ REQUIRES Remainder of specif= 


OVERFLOW DISK "disk ied file resides on 

name" another disk. POD 
cannot comptete until 
appropriate disk is 
supplied. 


Note: See “Common Utility Output Messages” for additional aid. 
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SUGGESTED ACTION 


None. 


Supply appropriate 
cisk. 


(4 


PL (Print Log Files): 


This utility allows the operator to list the contents of log-files present during any one particular session. 


Format: 


SYSTEM or S 
ERROR or E 


FROM date | time b 
PL file-name TO date | time My 


ENTRY number 
MIX number 
INPUT 
OUTPUT 


The option “SYSTEM” (or “S’’) is specified to list only system messages from the log-file. 
The option “ERROR” (or “E”) is specified to list only error messages. 


The option “FROM MM/DD/YY HH/MM/SS” is used to list the logged message from the specified date and 


time. If time is not specified, then 00/00/00 is assumed. MM = month, DD = day, YY = year, HH = hour, 
MM = minute, SS = second. | 


The option “TO MM/DD/YY HH/MM/SS”’ is used to list the messages up to that date and time. If time 
is not specified, then 00/00/00 is assumed. 


If the option “ENTRY” is used, the utility will print starting from the record number specified by the 
operator. 


The “MIX number” option is used to print all messages related to specified mix (number(s)). 
The “INPUT” and “OUTPUT” option allows the operator to print either input or output messages. 


Certain “defaults” are as follows: 
SYSTEM and ERROR messages; 
INPUT and OUTPUT messages; 
FROM 00/00/00 00:00:00; 

TO last date and time in log; 
ENTRY 1. 


All entries are displayed irrespective of their mix numbers. Any of these defaults can be reset at run time. 
If no real-time clock was available when the file was created, then no check will be made on the “‘time”’ portion 
of the operator input, and “‘N/A” will be printed under the ““TIME” heading on the report. 


Entries with multiple records will only have the record number and record contents displayed; all other col- 


umns will be blank since the contents of these records will all be of the same type, and created at the same 
time. 


Only entries which conform with either the defaults, or operator input specifications will be displayed, all oth- 
ers will be ignored. 


The range of values for ENTRY and MIX numbers are 1-65535 and 1-254 respectively. Checks at run-time 
are made on the values entered and messages issued if they are in error. 
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Examples: 


To print the contents of the log-file called SYS-LOG-HOLD: 
PL SYS-LOG-HOLD 


To print the error messages logged in the log-file called SYS-LOG-01: 


PL SYS-LOG-01 ERROR 


To print entries in SYS-LOG-HOLD file from record 100, related to mix number 12 from January 1, 1979 


until latest date: 


PL SYS-LOG-HOLD ENTRY 100 MIX 12 FROM 01/01/79 


Output messages: 


MESSAGE 


NO FILE NAME IN 
PARAM.FILE 
filename 


NO FILE NAME FOUND 
IN PARAMETERS 


ILLEGAL OPTION 
text. 


ILLEGAL VALUE 
number. 


ILLEGAL NUMBER OF 
RECORDS IN FILE 
filename 


ILLEGAL PARAMETER 
text 


NO TIME SPECIFICATION 
AFTER time option 
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POSSIBLE CAUSES 


x<filetname> option 
was uSed. The utility 
faited to find a 

file-name within the 
first 5, 80-byte 

records of the fite» 
"file-name™. 


One of the options 
is specified first. 


The option specified 
was not recognised. 


"number™ after either 
ENTRY or MIX 15 not 
within the attlowable 
range of numbers. 


*<filename> option was 
used. “filename” fite 
has more than 5» 8C™ 
byte records-. 


Input after a special 
entry is incorrect» 
or inaporogriate» 
that ts» TENTRY 
number". If "number" 
was not recognizable» 
this would produce 
the error). 


Input after etther 
"TO" or “FROM® 5s 
incorrect or inapp~ 
ropriate. 


SUGGESTED ACTION 


Check contents of 
"Starfite™ Cuse 


LIST) and recreate 
if necessary? 
input. 


re- 


Re~enter » 
first. 


Check input ard 
reenter. 


Check input and 


Check contents of 
"Starfitle™ Cuse 
LIST) and recreate 
if necessary. 


input and 
re"enteére 


Check 


Check input and 


re"enter « 


with file-name 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


A number after a Check tnput and 
GIVEN special entry (that rementer. 

1S» after MIX) was 

expected but not 

found). 


One part of the Check tnput and 
ALREADY SET operator input renmerter. 
message contradicts 
the other (that 1s» 
"INPUT" and "OUTPUT" 
specified simultén- 
eously). 


ILLEGAL TIME "time specification” Check input ana 
SPECIFICATICNA format incorrect reenter. 

time specification (that ts» “time"™ 

was typed before 

“date” if both are 

used. 


UNABLE TO OPEN PL unable to use a Verify (with PD) 

FILE required file. (EX: that file is on disks 
in uSe by Some other if file Is on correct 
program). cisk»s wait until progra 

using file goes to 

ECJ anc then retry 

PL. 


NO ENTRIES FROM WENTRY™ option was Check input ard 
ENTRY NUMBER used and nothing reenter. 
number equivalent to spec- 
ified “number™ was 
found in file. 
Note: This option wiit 
Start the processing 
at the first value it 
finds which is the 
Same as that given. 
If the “match” faits» 
this message displayed. 


filename IS NOT Specified file is not Check input ard recenter 
A LOG FILE of "tog7"file”™ format. if necessary. 


ILLEGAL FILE "filename” does not Check input ard 

NAME filename conform to standard rementer if necessay. 
CMS format (Cthat s> 

disk name might Ce 

toc tong). 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


NO ENTRIES FOUND During processing» Check input and 
WITHIN PARAMETERS End of File is reenter if necessary .| 

reached and no en 
tries have been er- 
inted. 


PARITY ERROR IN (Record number at 

READ OF FILE which error occurr- 

filename ed prints immediate” 
ly after message). 
Program encountered 
error on trying to 
read specified file. 
WARNING? | 
Program normally att- 
empts to continue 
processing. Howe€ver» 
if ENTRY option has 
been used and e€rror 
occurs white proc- 
essing this Comménd» 
the results might not 
be those rennuestecd. 


This is cisptlayed if» 
when analysing 
maintenance entry» 
certain information 
is tonger than the 
utility can handle. 


FUTILITY LIMIT REACHED 


UNRECOGNISED DEVICE This is displayed if» None. 
IN ERROR ENTRY when analysing the 

error descriptors no 

device can be found 

in the Hardware 

Configuration table 

which corresponds to 

this device type - 

hence no error counts 

can be updated from 
this information. 


4-94 


RM (Remove Files from Disk) 


(a function of SYS-SUPERUTL) 


This utility allows the removal of individual files and groups of files from disk. The disk areas associated with 
those files are returned to the available table. 7 


If the utility detects that a keyfile is to be removed and the <BOTH> option has been specified, then it 
will remove both the keyfile and the associated data file if both are on disk. If <BOTH> is not specified then 
only the keyfile will be removed. 


Format: 
file-name or 
RM disk-name / group-name < BOTH> 


Examples: 


To remove a single file: 
RM AR300 
RM PR1/PR300 


To remove a group of files: 
RM AR= 
RM INDISK2/IN3= 


To remove several different groups and/or individual files: 
RM 1C230, INO76, INDISK1/IN2= 


To remove a keyfile and associated data file: 
RM PR200K <BOTH> 


A request for the removal of a system file will cause the utility to output the following: 
filename IS A SYSTEM FILE 
AX “mix number”/RM ACPT 


Then, to remove a system file: 
AX mix-number/RM file-name OK (mix-number is the mix number of RM). 


If the operator types any other sequence the system file will not be removed. 


Example: 
RM NDL= 
NDL.INTERP IS A SYSTEM FILE 
12/RM ACPT 
AX 12/RM NDL.INTERP OK 
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Output messages: 


MESSAGE 


"filename™ REMOVED 


"filename”™ NOT REM™ 
OVED NOT FOUND 


"filename” NOT 
REMOVED * IN USE 


"filename”™ NOT 
SYSTEM 


INDEXED PAIR 
"file name*™ “file 
name™ REMOVED 


"filenane”™ 
"filename”™ NOT 
REMOVED = IN 
USE 
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POSSIBLE CAUSES 


File was removed. 


Specified file 
was not refroved. 


Specified file was 
not removed because 
it 1s Currently 
being uSed by the 
systeme- 


Specified file was 
not removed because 
it is a "system file” 
Cfor example» MCP» 

an interpreter» etc). 


Keyfile and assoctat- 
ed data file were 
removed. 


Keyfile and associat” 
ec data file were not 
removeds This message 
1s fotlowed by the 
reasone 


Specified keyfile and 
data file were not 
removed because at 
Least one 18 current” 
Ly being used by the 
Systeme 


SUGGESTED ACTICN 


Check input Creinput 
if necessary)», 

Check for correct 
Cisk. 


hait untit file is no 
longer in use» then 
re“minpute 


If file ts to be 
removed» tyoe 

"AX fix *number/RM 
file"néeme OK". 

If file 1s not to be 
removecds tyne AX 
rix/RM NO 


Check input Cresinput 
tf necessary) 

or | 
Check for correct 
cisk. 


Wait until files afre 
no Loncer in usee the 


; ae. 


SQ. (Squash Disk) ( 


When a disk unit is used extensively with a high degree of file activity involving creation and removal of files 
then it is possible for the available space on the disk to become so fragmented that it is increasingly difficult 
to find enough space in one single area to satisfy requests for disk space. This results in a degradation of system 
throughput with an increasing incidence of ““NO USER DISK” failures and extra time needed to search through 
available areas. This situation is known as “checkerboarding” of the disk. In the extreme case each area of 
disk in use is separated by an available area, as shown in the diagram below: 


The SQ utility is designed to eliminate checkerboarding of disk, either for the whole disk or part of the disk. 
This process is called “‘squashing” disk and is accomplished by moving each data area in turn to the first avail- 
able area at a lower address. If an entire disk 1s squashed then all available areas are merged into one area 
at high-address end of the disk, as in the next diagram: 


The options available within the SQ utility are: 


Squash of a complete disk. 


All data areas are moved to successively lower addresses until only one available area is left (as in diagram 
above). 


Partial squash 


Only data areas within a default section of the disk are moved to lower addresses within the section. 


Fast squash 


The aim of a fast squash is to create an available area of disk of a requested size. Only those data areas 
are moved which will allow an available area of a sufficient size to be created. 


Economic squash 


In this case, data areas are only moved if the gain in terms of available.space justifies the time spent in move- 
ment of the data area. As an example, consider the following case: 
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available # 1 
available # 2 


where data area #1 is 100 units, data area #2 is 200 units and both available areas are 1 unit each. If available 
areas are merged the available area gained would be 2 units. However, to acquire these 2 units, the 200 units 
of data area #2 would have to be moved. Therefore an “economic squash” would not move data area #2. 
In general terms, an economic squash will ignore small available areas that are interspersed in large data 
areas. However, in some cases an economic squash will have the same effects as a full squash. 


With all options of SQ a further option is available to print a map of. the entire disk in disk-address order 
both before and after squashing action. 


Input is as follows: 


Format: 
VERIFY 
ALL 
FAST number 
SQ disk-name 
BEGIN END 
FROM start-address TO end-address 


| LIST | 


note: the number is in the range 1 to 65535; the start-address and end-address are 6-digit hexadecimal disk 
addresses, for example, 0O0AB3, 01A375. 


Examples: 


To perform an economic squash of disk PR2: 
SQ PR2 


To check the integrity of disk PR2: 
SQ PR2 VERIFY 


To perform a full squash of disk PR2 and list the disk map: 
SQ PR2 ALL LIST 


To move data areas to provide one available area of 1000 sectors on disk PR2: 
SO PR2 FAST 1000 


To perform a partial squash on sectors 0 through 512 of disk PR2: 
SQ PR2 FROM BEGIN TO 000200 
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To perform a partial squash on sectors 512 through 4096 of disk PR2: 
AQ PR2 FROM 000200 to 001000 


To perform a partial squash on sectors 4096 to the last addressable sector of disk PR2: 
SQ PR2 FROM 001000 TO END 


Before performing any function which involves physically moving data areas, the integrity of the disk is 
checked. Integrity checking involves analyzing disk assignment to verify that the entire area of the disk is de- 
scribed in the file directories and available table, checking the directories themselves and attempting to resolve 
anomalies (for example, missing areas or overlapping areas). Only after the integrity is verified are areas of 
disk physically moved. 


Certain areas of disk will not be moved in any circumstance. These are areas of disk currently marked as 
in use, and any system log files. In addition, SO can only be run in a suitable mix, as defined by the MCP 
to safeguard the integrity of the disk. No user program can be run with SQ. During execution of SQ the MCP 
will reject any attempt to execute any utility or user program. 


Output messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


LARGEST AVAILABLE 
AREA IS number 
SECTORS. TOTAL 
AVAILABLE IS number 
SECTORS IN number 
AREAC 5S). xx *§Q 
COMPLETED*** 


Given on successful 
comoletton of SQ. 


NON“FILE OIRECTORY 
FULL - “PARTIAL" 
SQUASH REQUIRED 


Display during ver 
ification phase if 
there are no free 
entries when att” 
empting to add en- 
tries to the avait~ 
able table if miss- 
Ing areas are detec 
ted. 


SQ INVALID = NO 
INITIATING MESSAGE 


Selfrexplanatory 
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Run S@ with VERIFY 
LIST optionse Examine 
the c1Sk map to discover 
a section of the disk 
that can be squashed 
to create free entries 
in the ayaitabtle table 
Example: 
The pattern 

File Area 

Available 

File Area 

Available 
if squashed wiil create 
one free entry in the 
évailable table. In 
ceneral the # of free 
entries to be created 
equals the #4 of missing 
éreas that are not con” 
tiguous with any avait- 
abie area. 


Reminput. 
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MESSAGE 


SQ INVALID - INVALID 


PACK -ID 


S$Q@ INVALID - 
INVALID SYNTAX 


SQ INVALID - INTEGER 


MUST NOT BE GREATER 
THAN 65535 | 


SQ INVALID - INVALID 


ADDRESS 


xx* BAD SECTOR AND 
filename OVERLAP - 
NO WAY TO SEPARATE 
THEM. SAVE ANDZOR 
PURGE ANDO AT LEAST 
RETURN SC VERIFY 


x*x* file-name ANDO 
filesname OVERLAP - 
THERE IS NO WAY TO 
SEPARATE THEM. 

SAVE ONE OR BQTH> 
PURGE AND AT LEAST 
RERUN SQ VERIFY 


SQ ABORTED - 
REQUESTED AREA 
ALREADY EXISTS 


*** SQ ABORTED - 
INVALID DISK ALLOC. 
UNIT = 


kee DIRECTORY FID 
NE@ HEADER FIn FOR 
FILE filename- 
CORRECT USING CH 
AND FESTART SQ 
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POSSIBLE CAUSES 


Pack"id specified 
is longer than 7 
chéracters-. 


Selfrexplanatory 


The maximum # of 
Sectors requested 
for the FAST option 
is 65535. 


No address or an 
Invalid address Cfor 
example» 004615) was 
specified for the 
FROM or TO address 
with partial squash. 


Area marked in 
available table as 
"bad” overtaps with 
area allocated to 
file. 


Area allocated to file 
overlaps with area 
allocated to another 
file. 


Request was made with 
FAST option for an 
available e@erea which 
already exists. 


Disk labet 15 probably 
corrupted. 


Name of file in file 
directory name List 
does not match disk 
file header. The 
filename displayed 
1s that in the name 
List. 


“NY 


SUGGESTED ACTION 


Re~input. 


Re-input. 


Re~irput. 


S@ cénnot resolve this. 
Intecrity of file is 
Suspecte Remove the file 
after copying it to 
another disk for exam- 
Ination if necessary 

and rur SQ@ VERIFY, 


The two areas cannot 
be sepérated. Copy 
each file individualt y 
to arother disk for 
later e€xamination if 
required» remove them 
tFoths rerun SC VERIFY 


Disk must be assumec 
useless and should be 
re“inittatizecd. 


Enter “CH <FILE-ID> 

TO <FILEcCID> to correct 
the égénomoty Cthis 
rewrites the disk file 
header). 


|SQ INVALID - 
SPECIFIED DISK NOT 
AVAILABLE 


TO SQUASH 
IN THAT AREA 


SQ ABORTED = NO WAY 
TO GET REQUIRED 
AREA 


ke* MEMORY INCONS- 
ISTENCY OR SOME 

OTHER IRRECOVERABLE 
|PROBLEMS - RERUN SC 


THE DISK 


wee IRRECOVERABLE 


AND/OR REINITIALIZE 


zkx*x TOO MANY FILES 


- NO WAY TO SQUASH 
THE DISK 
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Setfr-exolanatory. 


A partial squash was 
requested and 5S@ 
found nothing to do 
in that section. 


xx* ADDRESS MISMATCH 
= SAVE AND REINITIATE 


ERROR ON DISK = SAVE 


OPEN AND/OR BAD AREAS 


Area size specified 
in the FAST option 
cannot be obtained 
either because it 

1S Larger than the 
total available 
space or because 
certain areas cannot 
be moved to retease 
available space. 
For example: 

Area # 1 100 units 

Ayvailabte # 1 100C 

units 

Area # 2 100 units 
Avaitable # 1 cannot 
be used if areas # 1 
and # 2 are inuSse or 
system tog files 
because areas # 1 and 
# 2 cannot then be 
moved. 


Internat work-tables 


In memory Cused by S€) 


are corrupted. 


Some addresses 


corrupted. 


1s corrupt. 


Self-exptanatory. 


Make disk present and 
rerun $03 check input. 


in disk 
directory are probabiy 


Try to dump or copy 


SUGGESTED ACTION _ 


Attempt to remove 
unwanted user files? 
rerirput SQ. 


Rerun SQ VERIFY. 
problem persists» 
request technical 
assistance. 


I f 


Try to dump or copy 
files from the disk. 
Disk must be reinit? 
ializec before reuse. 


files from the disk. 


Cisk must be reinit= 


ialized before remuSe. 


Save required fites from 
disk» then reinitialize 
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1ESSAGE 


see DISK INTEGRITY 
SUSPECT = USAGE MAP 
OF THE DISK WILL BE 
PRINTED CIF LIST 1S 
NOT SET) 


kee AREAS STILL 
MISSING * RERUN 
SQ VERIFY 


kee LAST SQ 

EXECUTION WAS ABNOR-= 
MALLY TERMINATED WHEN 
MOVING FILE - file- 
name-INTEGRITY OF FILE 
SUSPECT. EXECUTION 
CONTINUES | 


w«e SQ ABORTED ~- 170 
ERROR AT DISK ADDRESS 
aNNNNNNQ 


zkx*e 1/0 ERROR ON 
file-name FILE 
SKIPPED = EXECUTION 
CONTINUES. 


wee WRITE ERROR IN 

NEW LOCATION WHEN 

MOVING FILE AREA. 

DISK ADDRESS - 

J@NNNNNNQ. THIS 

AREA SKIPPED - 
ECUTION CONTINUING 


- POSSIBLE CAUSES 


$8 has detected anc 
resolved an overlap 
Situations but disk 
remains suspect. 


A FAST squash has 
detected that areas 
of disk are not 
accounted for. 


System crash occurr” 
ed while file areas 
was being moved. 


Hard error on disk 
persists after 10 
retries. 


Hard disk error 
encountered. File 
is not moved. 


Hard error encount” 


ered when moving file 


area to avattable 
ar@ae 


NOTE 


SUGGESTED ACTION 


Scrutinise disk map»e 
request technical 
assistance. 


SQ VERIFY witt return 
missinc areas to the 
évailatile table. 


Remove suspect file. 


[If address is outSsice 


directory areés»s remove 
offerding area with 
xD utility. 


Available area is teft 
as availale and should 
te XCred after squash 
FOJ. 


Error messages marked with ‘“‘*@e” indicate that a hardware or system software er- 
ror has occurred or that the disk itself is suspect. If these persist, request technical 


assistance. 


General Guidelines 


If the information contained on a disk is important always ensure that backup exists before attempting to 


squash it. 


Always run “SQ VERIFY” before running an actual squash. This will give an indication of the state of the 


disk. 


Do not allow disks to become too fragmented before squashing them. A full squash can be a lengthy process 
and can be avoided by running “SQ VERIFY” on a regular basis and running partial squash when the disk 


starts checker-boarding. 


“SQ VERIFY” is a means of checking the integrity of any disk and if run on a regular basis may help pin- 
point sooner rather than later any degradation in hardware performance or system software bugs. For disks that 
are in constant use “SQ VERIFY” should be run immediately after the first clear start of the day. This can 
help prevent catastrophic losses of information. 
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SYCOPY (Copy Library Tapes) 


This utility allows the operator to copy, compare and merge library tapes and cassettes (tapes created by 
DUMP/UNLOAD utilities). 


Format: 

CPY — number — file-equate 
or 
CMP — number — file-equate 
or 

SYSCOPY CCM — number — file-equate 
or 
MRG~- — file-equate 
or 
TEACH 


Where number is in the range 1 to 7 and the default value is 1. 


file-equate is defined as one or more of the following entries: 
FI default-name NAME actual-name 


The default-names for input tape is “IN” and for output tapes ‘““TAPE.1” through ““TAPE.7”, except in MRG 
function where the input tape names are “SYSTEM” and “UPDATE” and the output tape name is “OUT”. 
All output tapes are locked after job termination. 


The copy function, CPY, allows for one input tape to be copied to up to seven output tapes. 


Examples: 


To copy one input tape labelled “IN” to two output tapes, labelled ““TAPE.1” and “TAPE.2”: 
SYCOPY CPY 2 


To copy one input tape labelled ““FRED” to one output tape, labelled ““FRED.OUT”: 
SYCOPY CPY FI IN NAME FRED FI TAPE.1 NAME FRED.OUT 


The compare function, CPM, allows for one input tape to be compared to up to seven input tapes. 
Examples: 


To compare one tape named “IN” with three tapes named “TAPE.1”, “TAPE.2” and “TAPE.3”: 
SYCOPY CPM 3 


To compare one tape named “FRED” with one tape named “TAPE.1”: 
SYCOPY CPMIFI IN NAME FRED 


The copy and compare function, CCM, allows the copying of one input tape to up to seven output tapes 
and then the comparison of the same input tape with the output tapes. 


Examples: 


To copy one input tape named “IN” to three output tapes named ““TAPE.1”, ““TAPE.2”, “TAPE.3” and 
then to compare “IN” with “TAPE.1”, “TAPE.2” and “TAPE.3”: 


SYCOPY CCM 3 


The merge function, MRG, allows two input tapes to be merged to one output tape. If there are duplicate 


files on the input tapes then the version on the second tape (default name UPDATE) will be copied to the 
output tape. | 
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Examples: 


To merge two input tapes named “SYSTEM” and “UPDATE” and output one tape named “OUT”: 
SYCOPY MRG 


To merge two input tapes labelled “A”? and “UPDATE” to one output tape named “B”’: 
SYCOPY MRG FI SYSTEM NAME A FI OUT NAME B 


The TEACH function allows the operator to list the syntax of the utility on a printer. 
Example: 
SYCOPY TEACH 


Output Messages: 


—|MES SAGE | POSSIBLE CAUSE | SUGGESTED ACTION 
number TAPECS) successful copy 
COPIED function 
number TAPE(CS) successful compare none 
COMPARED function 


number TAPECS) success ful copy and 
COPIED AND compare function 
COMPARED 


2 TAPECS) MERGED successful merge 
function 


INVALID SYNTAX = The initiating message Check input and 
SYCOPY ABORTED contains some invalid rementer if 
specifications for necessary 
example: invatid or 
miss=spelled options 
number following MRG=» 
file equate to an 
invalid fite-name> 
misespeliled file> 
equate clause 


COMPARISON ERROR ON The compare function Re=run the SYCOPY 
tape-name = TAPES failed» possibly due function with good 
NOT IDENTICAL - to a hardware mai- tapes and drive 
SYCOPY ABORTED function 


RECORD SIZt OIFFERENT The record size of Check input tape 
ON tape-name the tape specified and rew=run SYCOPY 
differs from the if necessary 
record size of the 
Input tape 


WAITING tape"name/ Specified tape is | Mount the correct 
FILEO000 Cor FI00000) not available» or tape or investigate 
AT NO FILE tape drive cannot. tape drive for 

read tape correctly errors 
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TAPELR (List Library Tape Directory) 


This utility allows the operator to print detailed information about the library tape files. Output will appear 
either on the line printer or the console printer. 


Tapes about which information is required are identified by “‘library-tape-name’’. More than one tape name 
may be requested during a single run of TAPELR. 


Format: 


TAPELR library-tape-name 


Examples: 


To print detailed information about the files on a tape called PRTAPE: 
TAPELR PRTAPE 


To print detailed information about the files on tapes called PRTAPE and ICTAPE: 
TAPELR PRTAPE ICTAPE 


Output format: 


Eight columns of information will appear for each library tape indicated. The column headings, the format 
of the “values” these columns contain, and the significance of these “values” is as follows: 


HEADING VALUE SIGNIFICANCE 
FILE NAME i2 character File name 
ACTUAL SIZE 7 dicits Number of recorcs in this file 
MAXIMUM SIZE ¢ digits Maximum # of records this file 
may Contéin. 
RECORD SIZE 5 diacitts # of characters in each record 
RECS/BLOCK 5 digits f of records in each block 
CREATED 5 dicits Date file was createc (Julian 
YYDDD) 
ACCESSED 5 dicits Date file was tast accessed 
by a program (Julian YYDOOD) 
FILE TYPE 8 cheracters See Note below 


Note: FILE TYPE will be one of the following: 
DATA -—- normal data file 
CODE - object program file 
KEY - key file 
SYSTEM - system file (for example, MCP, interpreters) 
SRCELANG - source language file 
SRCELIBR —- source library file 
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Output messages: 


MESSAGE 


library~tape-name 
NOT A RECOGNIZED 
DUMP TAPE 


POSSIBLE CAUSES SUGGESTED 
This tape was not 

created by either 

DUMP or UNLOAD 

functions of LD 

utility. It is 

ignored by the 

TAPELR utility. 


Note: Refer to “Common Utility Output Messages” for additional messages. 


AC TION 


| 


TAPEPD (Print Name of a Library Tape) 


This utility allows the operator to print the names of files found on a library-tape. More ca one wipe: name 
may be requested during a single run of TAPEPD. / 


Format: 


TAPEPD hibrary-tape-name 


Examples: 
To print the names of files found on a tape called PRTAPE: 
TAPEPD PRTAPE 


To print the names of the files found on tapes called PRTAPE, ICTAPE, and GLTAPE: 
TAPEPD PRTAPE ICTAPE GLTAPE p 
Output format: 


For each tape requested, the following information is displayed: 
MT library-tape-name DUMPED ON day of week DD month YY contains: 


This message precedes the names of files found on each tape. The list itself contains 3 files per line. 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


library-tape-name This tape was not 
NOT A RECOGNIZED created by either 
DUMP TAPE the DUMP or UNLOAD 
| function of LD 
utivity. It is 
ignored by the 
TAPEPD utility. 


END TAPEPD /€nd of job message. 


Note: Refer to ‘““Common Utility Output Messages” for additional messages. 
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TL (Transfer Log Files) 


If logging is enabled following any warmstart, a number of “‘log-files’’ are in use. The purpose of these files 
is to maintain a record of all input/output messages that appear on the SPO within this given period of time. 


In order to produce easy access to all the files, they are consolidated into one large file. This is done through 
the use of the TL utility. 


Format: 


TL | disk-name / file-name | RECOVER 


““File-name”’ is the name the user wishes the consolidated file to be called. 
In order to permit a correct consolidation, there may be NO other programs running at the time when TL 
is initiated. 


The utility will determine the number of files to be consolidated and also the size of the consolidated file. 
It will then transfer each “ready-to-transfer’ , closing the consolidated file after each log-file has been trans- 
ferred, until it reaches the file which was in an ‘“‘active ‘”’ state at time of execution of TL. 


If the “RECOVER” option has been specified, then the utility will enter the “‘active’’ log file when it reaches 
it and it is not in use, and transfer all entries up to the latest. If the “‘active” file is in use then the utility 
displays “ILLEGAL USE OF RECOVER PARAMETER, ACTIVE FILE NOT CONSOLIDATED”, and will 
consolidate only the “ready-to-transfer’’ files. 


If the “RECOVER” option has not been specified, consolidation will end when the “active”’ file is reached. 


All log-files transferred will be left in a “‘transferred”’ state. 


Examples: 


To transfer all ‘“‘ready-to-transfer’> SYS-LOG files to LOGHOLD: 
TL LOGHOLD 


To transfer all ‘‘ready-to-transfer” SYS-LOG files to LOGHOLD on the disk called ARDISK1: 
TL ARDISK1/LOGHOLD 


Output messages: | 
MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ILLEGAL FILENAME Specified fite- Check input and 
i filename Name contains too re~input. 
many characters - 


UNABLE TO OPEN Utility cannot Check with KA on 


TRANSFER FILE “create” a con- availatle space: use 
filename solidated file RM if recessary and 
with the name retinput.- Check drivel] 
requested (for fediae 
example» no disk 
Spaces no disk 
media). 
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29 


MESSAGE PCSSIBLE CAUSES SUGGESTED ACTION 

FILE file-name The utility was urable Correct the file- 

NOT FOUND to find the specified name and remingute 

file-name 

FILE file-name The specifiec fide is Wait until the task 

IN USE wn usee using the specifed 
file goes to end of 
jobe 

NO LOG FILES FOUND This ts cisolayed if None. 

FOR CONSOLIDATION the utility» on 


attempting to ceter- 
mine the number and 
sizes of tog files 

to te transferrede 
was unable to find 
any with a filerid of 
the form "*SYS*LOG- 


NA" 
ILLEGAL USE OF The utitity ts Nonee 
RECOVER PARAMETER - executed with RECOVER 
ACTIVE FILE NOT option. The active 
CONSOLIDATED file can only be 


consolidated at 
warmstarte 


INVALID CHARACTER Some invalid character Correct the ingut 
IN IDENTIFIER input has been typed in the and re~inpute 
input . 


TRANSFER COMPLETED Successful termination 


of the utility. 


ND READY~TO“TRANSFER No log-files tn either None. 
FILES FOUND an “active™ or “ready= 
to=transfer™ state 
were founde No consol- 
idation will occur. 


NO ACTIVE LOG No file in the “act? None 
FILE FOUND ive™ state was found. 


TL successful Enc of Nonee 
Jobe 


TRANSFER COMPLETED 


PARITY ERROR IN READ Read or write parity None 
OF FILE filename errors found for 


or specified files. The 
PARITY ERROR GN WRITE record number at 
10 FILE file-name which error occurr= 


ed will be dispiayed. 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


If utility continues 
processings then the 
message “CONTINUING 
PRCCESS" will cisolay. 
Ctherwise TL will go 
to End of Job ard 
leave partially con- 
solidatec files, de- 
pending on where 

error occurred. 


NO FILE NAME FOUND The *“RECOVER™ option Correct the input 
IN PARAMETERS was used anda fiie and re~enter. 
name was not given. 


CONTINUE PROCESS This message followed None. 
the parity error 


message if utility 
able to continue 
processes 
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UNLOAD (Unload Files from Disk to Library Tape) 


This function, a part of the utility LD, allows the operator to copy files from disk to a library tape. The 
files will be deleted from the disk after they have been copied to the tape. 


Format: 


| LD UNLOAD TO library-tape-name | FROM disk-name 
file-name or | | 
group-name < BOTH> 


If the <BOTH> option is used immediately after a request to dump a keyfile, the associated data file will 
also be dumped, provided it resides on disk, 


Examples: 


To dump all files from disk beginning with the letters, “PR” to a tape called PRTAPE; and then remove 
them from disk: 
UNLOAD TO PRTAPE PR= 
To dump the keyfile called AR200K and its data file from a disk called APBU to a tape called ARTAPE, 
removing them from disk after dumping: 
UNLOAD TO APTAPE FROM APBU AP200K <BOTH> 
To dump from the system disk files called AP020, AP030, and APTASK to a tape called APTAPE; removing 
them from disk after dumping: 
LD UNLOAD TO ARTAPE AP020 AP030 APTASK 


Since “UNLOAD?” is a part of the utility LD, “LD” is actually what will appear in a mix message. To discon- 
tinue the UNLOAD function, DS mix-number/LD must be used. 


Output messages: 


POSSIBLE CAUSES SUGGESTED ACTION 


NO FILES IN THE specified group Check input? retinout 
FAMILY group-name was not found on if necessary. 
1'ON DISK disk*name this disk. Check for correct 


FOR UNLOAD ; cisk. 


NO FILE file-name Specified file was Check input and reinput 
ON DISK disk=name not found on this if necessary. 
FOR UNLOAD diske Check for correct 

Ciske 


|]ftle*name NOT Specified file Wait until the file 
DUMPED ~ IN QUTPUT cannot be dumped is not tn use and then 
USE DUMP ABANDONED as it is in uSe. remerter the UNLOAD 
- TAPE BEING If "*ABANDONED” message message for ali files. 
PURGED 1S givens tape is 
purged and UNLOAD 
goes to E0NJ. 
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POSSIBLE CAUSES SUGGESTED ACTION 


file-name NOT DUMPED Specified file was 


- HAS BEEN REMOVED. removed between 
DUMP ABANDONED - the start of UNLCAD 
TAPE BEING PURGED anc the time when 


it was to be dumped 
to tape. File cannot 
be dumped. Tape is 
Purged an UNLOAD 
goes to EDJ. 


filename NOT DUMPED Contents of specified Check input and 
= HAS BEEN ALTERED> file were changed re-enter if necessary. 
DUMP ABANDOND - between the start 

TAPE BEING PURGED. of UNLDAD and the 

time when it was 

to be dumped to 

tapee File cannot 

be dumped. 


file*name LOAD/DOUMF End of file has teen 

DISCREPANCY reached before 
expected. Implies 
erroneous Disk File 

Header. 


filename NOT DUMPED <BOTH> option was If specified data file 
- DATA FILE NOT ON specified» but déta Cump is required» supply 
LINE file was not found ctility with backup 

on diske copy of file if exists. 


DUPLICATE filename More than one recuest 
ALREADY BEING DUMPED was made to UNLCAD 
Same file. 


file-name REMOVED UNLOAD success ful> 
original file on disk 
Was removed. 


filename DUMPED | UNLOAD successful. 


Note: Refer to “Common Utility Output Messages” for additional messages. 
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UPDATE (Disk File Update) 


This delity allows the operator to construct new disk files from existing files. “CREATE” and “AMEND” 
use many similar features. 


Format: pou 
UPDATE | disk-name / filename _| A number | 


N 


FILESIZE number 
TO new-file-name CRUNCH 


The existing file must be a source or data file. Attributes such as Record Size will be taken from this file 
and used for the “new’’ file. 


Input may be specified as “A” (alphanumeric) or ‘“N” (hexadecimal). (see CREATE utility for details). 


The “number” option may be used to set “tab” positions for character input. (see CREATE utility for de- 
tails). 


The maximum number of records likely to be written to the new file may be specified using the FILESIZE 
option. If no total number of records is specified, the number will be taken from the old file. 


The CRUNCH option allows the operator to specify that the new file should occupy the minimum area of 
disk, but never be extended. 


The utility operates in three modes: “Record Modify” (PK2), ‘Record Select” (PK3) or “Record Insert” 
(PK4). 


PK1 is used to write the last record processed to the new file and then select and print the next logical record 
from the old file. The printout will show the record number in the old file of the selected record, together with 
the next record number to be written to the new file. 

PKS is used to delete the last record printed by selecting and printing the next logical record from the old 
file without writing the last record to the new file. The printout will show the record numbers in the old file 
of the selected record, together with the next record number to be written to the new file. 


If PK3 is used, the required record is identified by logical record numbers using this format 


| RECORD number 
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The “number” cannot be less than the last record obtained from the old file, or greater than the number 
of records in the file. During the process of locating the required record, all records from and including the 
last record processed, up to the one immediately prior to the selected record, will be copied from the existing 
file to the new file. When found the selected record will be printed, with its record number in th old file fol- 
lowed by the record number that the next record written to the new file will take. “Record Modify’ (PK2) 
or ‘Record Insert’? (PK4) may then be selected. Note that a record inserted by Record Insert mode will be 
positioned after the selected record in the new file. Selecting Record ‘‘0”’ allows records to be inserted before 
Record 1 of the old file. 


PK2 is used to make alterations to existing records. This PK operates as PK2 in the CREATE utility (see 
CREATE for details). 


PK4 allows the operator to insert additional records in the new file after the last selected record of the old 
file. Input may be made in accordance with the specified tab stops. The utility prints the record number in the 
old file of the last record taken from the old file, and the record number in the new file, of the next record 
to be output, prior to accepting keyboard input. When all insertions have been made at a particular point in 
the file, an available PK may be pressed to select the next mode or terminate the utility. NOTE: to insert a 
record at the beginning of the new file, Record “0”? should be selected in Record Select Mode, prior to Selecting 
Record Insert Mode. 


Examples: 


To update a source file called ““APFILE” of record size 40 bytes into a file called “APFILE2”’. 
UPDATE APFILE 5 10 15 20 TO APFILE2 


The utility will illuminate PK1 and PK6. By pressing PK1, next sequental record will be selected and printed. 


As the utility is already in the Record Select Mode, by typing a record number, the specified record number 
and its contents are printed. 


4 4 ABCDEFGHIJKLMNOPQORST 


Note that the first ‘‘4’’ is the sequence number in the old ‘“APFLE” and the second “4” is the sequence num- 
ber in the “APFILE2”’ file. 


At this point the following PKs are available for selection: 
PK1 — select next sequential record and print 
PK2 — modify the selected record 
PK4 — insert new record after selected record (that is, ‘4’’) 
PKS — delete the last selected record by selecting next record 
PK6 — terminate the utility 


To replace characters within a selected record, press PK2 and type the replacement 
D:ZZZZ: OCKI 


resulting in 
4 4 ABCDZZZZIJKLMNOPORST 


To insert characters within a selected record, type 
L:XXXXXX: OCK2 


resulting in 
4 4 ABCDZXXXXXXZZZOPORST 
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To insert a record after record 7 of the existing file, press PK3 (Reéord Select Mode) and type a record num- 


ber. 
7 OCK1 


Note: At this point the record selection number given cannot be less than the last selected record, for exam- 


ple, records from 1 through 3 cannot be selected). 
Press PK4 (Record Insert Mode) and utility will priné last selected record number on left and next record 


Pa 
i 
3 


AAAAAA | 
; 


number after that and allows operator to key in recofd to be inserted. 
7 8 : 
é | 
The record inserted will have a sequence number of “8” in the file “APFILE” and will contain “AAAAAA” 


Output messages: 
Refer to the section on the “CREATE” utility for output messages. 


AR eae g 


Pes. 045209, 
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WL (What Log file) 


This utility allows the operator to determine the number of log files present and their status. 


_- Format: 


WL 


The utility displays the following information: 


FILE STATE SYS-LOG- 
ACTIVE nn 
READY-TO-TRANSFER nn nn etc 
TRANSFERRED nn nn etc 
NEXT-ACTIVE nn (nn) 
NOT USED nn nn etc 


where nn represents values between 01 and 16. 

When the ACTIVE file becomes full, the MCP executes the WL utility and hence the operator is informed 
of the states of log files. The user can then decide whether or not to execute TL so as to preserve the log 
files before any overwriting of log files occurs. 


Output messages: 


IMESSAGE POSSIBLE CAUSE 29UGG<STED ACTION 


ING SYS*LOG*NN Logging has not been Request technical 
TITLES FOUND ) initiated | assistance if logging 


is required (refer to | 
appropriate section | 
of the SQG) 
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XD (Delete Bad Disk Sectors) 


This utility allows the disk directory to be marked such that selected portions of the disk will not be used. 
The utility will normally be used after recurrent errors of the message 


DK...ERROR 


where the dots indicate further information. Refer to section 7, MCP output messages, for the following num- 
bered messages: 


2 PARITY ERROR 

3 TIMEOUT ERROR 

4 ADDRESS ERROR 

45 PARITY ERROR (fatal to program) 
46 TIMEOUT ERROR (fatal to program) 
47 ADDRESS ERROR (fatal to program) 


The further information will indicate the disk address at which the failure occurred 
The utility is initiated as follows: 


Format: 


XD disk-name address Jength 


The disk-name is the disk-id of the disk from which sectors are to be deleted. The area to be deleted is given 
in hexadecimal by the starting address and length. 


Example: 


To delete sixty-four sectors starting from hex 395F from disk PR2B: 
XD PR2B 395F 40— __ 


£ ow at ie Tre Bees bay = tf 
ly & flee Lo Bet eg "Ade oe & 
VW Onodibe, 


sasail edt, 
The specified sectors must not be in use as part of a file. The area must be made 
available by first removing any file if necessary. 

Warnings: 


Once sectors are deleted via XD from a disk, they can be restored to use only by a disk initialization. Do 
not therefore XD a larger area than required. 


As XD alters the disk directory, do not run any other programs with it. 


Do not execute XD from the same disk as the one from which sectors are to be deleted: for example, it 
is recommended that XD is always executed from the system disk and always deletes sectors from a user disk. 


Output messages: ; | 
MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
alengtha SECTORS Successful termiration 


FROM gaddressa of XD. 
DELETED 


DISK disk-name Specified disk is not Check input: make disk 
FOR xO NOT AVAILABLE available. ready- 
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JONLY Qtengtha Onty the given tencth 

SECTORS CAN BE can be XO~ed because 

DETECTED the amount soecified 
1S greater than the 
available space at 


that point. 


AVAILABLE TABLE FULL No entries teft in 

- ENTRY Qaddressa available space 

atengtha LOST table for XD to 
complete propertly. 


SECTORS FOR xD Requested sectors 
NOT AVAILABLE are atlocated to a 
fites missing» 
or previously 
XD-ed. 


CANNOT DELETE SECTORS Onty the part of the 

FROM Qaddressa area specified for 
deletion 1s available. 
The utility witl 
remove the available 
area onlye 


ADDRESS aaddressa The sector address 
BEYOND END OF DISK specified is greater 
disk-name than the address of the 


last physical sector on 


the disk. 


Can te RM~ed to 
Make the Sectors 
ayaitable. 


Use the KA utility yo 
cGetermine if any files 
can be removed to 
increase the available 
space surrounding 

the bad afea. 


The cisk may stittl be 
used» but a KA will 
indicate some sectors 
which cannot be access- 
eds these may only be 
retrieved by itinitial=- 
izinc the disk. 


Refer to a KA list- 
Ing to determine 
which file» if any» 


None 


None 


Note: Refer to “Common Utility Output Messages” for additional messages. 
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SECTION 5 
THE SORT/MERGE 


INTRODUCTION 


This section describes the capabilities of the SORT facility. There are two modules: the sort itself, known 
as the “‘sort intrinsic’ (filename SORTINTRINS), and an interface to this intrinsic which allows the user to 
specify particular sorts and merges. The latter module is sometimes called “‘the sort”, but is more properly called 
the “‘sort language processor” (file name SORT). The sort intrinsic is implementation-dependent, as it uses spe- 


cific hardware features where possible (although output messages are standardized), while the sort language. pro- 
cessor is a CMS common item. 


This section first describes the user interface to the sort, and then covers the various facilities in some detail. 


The interface to the sort from COBOL programs is described in the COBOL language reference manual. 


GENERAL FEATURES 


The following capabilities are provided : 


The records within a file may be sorted on a series of specified keys, each key ascending or descending, using 
a regular sort or an in-place: sort. 


(suitable for use as an ADDROUT file in RPG or for limited access in COBOL) may be created 


Meer encanta tm RAO ES EI LO ETRE RI IR REI OEE ee ENT a A FR RS 


from a file using a series of keys, each ascending or descending. 


A key_file (suitable for full indexed access) may be created using a specified unsigned key (ascenc 
with an . optional check for duplicate keys. 


ding only 


A number of files may be merged using a series of keys, each ascending or descending. 
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INVOKING THE SORT 


The sort is executed by entering the name SORT preceded by disk-name if not on the system disk, and fol- 
lowed by the sort language specifications or an asterisk plus “‘star-file’” name. The “‘star-file’’ contains the sort- 
language statements, and may reside on card, cassette, or disk. The star-file name may ‘be omitted: in which 


id ois sos Sn ater banearduaRien eee 


case the sort statements must be on a system disk file named SORTSPEC. 


Examples: 


To invoke the sort using a star-file named SRTLANG on the system disk: 
SORT\SRTLANG 


.To execute the sort from disk PB4, using a star-file SORTSPEC on the same disk: 
PB4/SORT ‘PB4/SORTSPEC 


/{ Note that the star-file must have a record size of not_more than 90 bytes. If the sort specification is given 
/}in the initiating message it cannot be longer than 255 characters. If the sort statement is Zipped from a user. 
program it cannot be longer than 716 characters. If it is not possible to specify a complex sort or merge within 


these limitations, a star-file should be used. 


For a one-part star-file name of 7 characters or less, the file will be searched for first on cards, then on cas- 
sette, then on the system disk. For a two-part name the file will be searched for on a user disk. For a one- 
part name of more than 7 characters, the file will be searched for on the system disk. 


If the required file is not found, the sort displays 
[PILE filename UNAVAILABLE | 
FIX AND REPLY “OK” ELSE <NULL> 


and waits on an ACCEPT. 


There are two alternative responses: 
make the file present_and enter OK to the ACCEPT, to resume execution, or 


If the specification statements are provided in the initating message, control characters such as carriage return 
and line feed are treated as space characters. 


A star-file on cassette must be created by the COPY utility, not the LD utility. 
A star-file on disk must be of type data or source, and should not be in use by other programs. 


Input statements may be printed on the printer, unless inhibited by a user option (see later), or if provided 
in the initiating message. 
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THE SORT LANGUAGE 


The specification for a sort consists of three statements: 
_ (4) the FILE statement 
(2) the KEY statement 
®) the USER-OPTION statement 


There must be one file statement, one key statement, and, optionally, one or more user-option statements, 
in any particular sort invocation. All keywords are reserved: that is, they can only be used in the place specified 


below and cannot be used for other purposes such as filename. 


The File Statement 


This consists of two parts; the first describes the input file(s) and the second describes the output file. Multiple 
input files are used only for the merge, which is specified as a user-option (see later). A sort must have onl 
one input file; a merge may have up to 16 input files. 


Format: 


SoRmt Fick 


DISK | PURGE 
CARD | Vv | | V 
TAPE | records 


CASSETTE PURGE ‘ record-size per-block 
DISK] 


ammonia RAPS Ree RAMEE MME MAR Doe 


KEYFILE 
TAGFILE 


CARD 
TAPE 
OUT mfid / fid CASSETTE 


DISK 
PRINTER 


Rules for the file statement are as follows: 


The medium for the specified input file(s) and output file is indicated by the keyword DISK, CARD, etc. 
When the medium is DISK, the absence of a disk-name (mfid) indicates the system disk. CARD refers to 80- 
column card only. TAPE refers. to magnetic tape only. CASSETTE refers to magnetic tape cassette only. DISK 
refers to any kind of disk-device. The input file for_a tagfile or keyfile creation must be on disk. 


SSAA OLEATE LO NTT 
So 
eS INT 
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The PURGE option indicates that the input file(s) are to be purged after use. 


The record size and records-per-block values are numeric values. When the input medium is DISK, the record 


isize and records-per-block may be omitted. For a merge specification, input disk file descriptions with record 


i 
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size specifications may be interspersed with descriptions without such specifications. 
If the records-per-block is omitted and record size is given, a blocking factor of 1 is assumed. 
In_all_cases (except an index sort), input and output files must have the same record sizes. 


The values of record size and records-per-block may be omitted for output files. For a sort, the values as- 
sumed are those of the input file. For a merge, the values assumed are those of the first specified input file. 


For a tagfile creation sort, the output specification enclosed in parentheses must be the single word TAG- 
FILE. The output will be disk and record and. block sizes are not user definable. 


The Key Statement 


This statement defines the record key(s) that are used for the sort or merge. 


A number of keys may be specified, each key description being enclosed in parentheses. The first key will 
be the major key and additional keys will be minor keys of decreasing significance. 7 


Format: 


ASCENDING 
| A NUMERIC R 
KEY ( location length DESCENDING UN L 
D SA | 
SN 
SSA 


The “location” is a numeric value specifying the position of the key relative to the start of the record, in 
4-bit units. The first 4-bit unit has a location of 1. The key location is given by the position of the left-hand 
4-bit unit in the key (which, depending on the key format), may be a character or a sign. The key should start 
on a byte boundary unless a record sort with a numeric key is performed. 


The ‘‘length” is a numeric value specifying the key length, in 4-bit units. This must include the sign, for signed 
keys. 


The keywords ASCENDING and DESCENDING determine the order of collation. These keywords may be 
abbreviated to A and D respectively. If omitted, the default is ASCENDING. 


The format of the key is specified by one of the following keywords: 
ALPHA or UA — unsigned 8-byte alphanumeric 


NUMERIC or UN — unsigned 4-bjtenumeric 
SA — signed 8-bit alphanumeric 


SN — signed 4-bit numeric 


SSA — 8-bit alphanumeric with separate sign 


The default is ALPHA. 


For a signed key, the position of the sign is specified by one of the following keywords 
R — right-hand (least significant) end of key 
L - left-hand (most significant) end of key 


The default in L. 


For a description of key types and sign zone interpretation, see later under “KEYS”. 


The User-Option Statement 


These statements have three functions: 
to specify which function is required 


to tailor a sort or merge to the particular machine configuration (memory, paate availability, etc). 
to add comments 


The user-option statements are optional; if more than one are used they may appear in any order relative 
to each other or to the file and key statements. 


INDEX 
INPLACE 
MERGE 


SYNTAX 
NOPRINT 
NODISPLAY 


Format: 


NODUPLICATES 
DUPLICATES 


COMMENT comments 
FILESIZE number-of-records 
MEMORY memory-size 


The type of sort is given by one of the keywords INDEX, INPLACE, or MERGE. If one of these does 
not appear, a regular full record sort is assumed. The keyword - INDEX specifies the creation of a keyfile or_ 


tagfile, depending on the output file details (see FILE statement). The . keyword INPLACE specifies a full record 
sort using a minimal amount of disk work space. The keyword MERGE specifies a merge of several input files. 


Note that if the INPLACE option is specified on a system that has not implemented the inplace sort, then 
‘a regular full record sort will be performed. 


The keyword SYNTAX specifies that a check on the correctness of the sort statements is to be made without 
the sort actually being performed. 
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be the first entry. If the statements are input via the SPO they are not printed and so this keyword is not re- 
| quired in this case. The NOPRINT option also affects the printing of error and warning messages (see later). 
| The keyword NODISPLAY controls the display of messages on the SPO during the sort. This option can 
be used both in initiating messages and from file-oriented statements. It suppresses startup and termination mes- 
‘| sages. It does not affect the display of error and warning messages. Error and warning free sorts and merges 


| The keyword NOPRINT stops the listing of the sort statements on the printer. If used, this keyword should 
| will show no SPO activity if this option is used. 


Sey, 


‘The keyword NODUPLICATES specifies that duplicate keys are not allowed in a keyfile creation. The key- 
«< word DUPLICATES specifies that duplicate keys are allowed in a keyfile creation. Both options are valid only 


t when creating a keyfile. If neither is specified, the default is NODUPLICATES. 


ae eres 


The keyword COMMENT introduces comment text. The end of the comment text is either the end of the 
input or the end of a record if the input comes from a starfile. Comments may appear between user-option 
statements and between file descriptions and key descriptions. 


The keyword FILESIZE provides the following capabilities: 


specification of,sort disk work space where the input file is not on disk (this use is not required if the input 
is from disk). 


specification of maximum size of the output file if on disk. 


allowance for future expansion of the output disk file where the sort/merge will not by default create a large 
enough file. 


- This keyword should be followed by a number giving the specified maximum number of records. For non- 
ees output files, the value is used for optimization purposes. If not used, default values are assumed where 
necessary. This option is not applicable to the inplace sort or to keyfile or tagfile creations. 


The keyword MEMORY specifies the amount of non-overlayable work area to be used by the sort. This op- 


tion is not applicable to the merge or to the inplace sort. If this is not enough for a successful sort, then this 
option is overridden. The memory size is in bytes; for example, MEMORY _ 1024. 


The keyword WORKDISK enables the regular sort to utilize disk space in an efficient manner. It is not appli- 
cable to the merge or inplace sort. When the work-disk is specified, the sort locates up to half the work space 
on that disk, with the rest on the system disk. If this option is not used, but the input or output file is resident 
on a user disk, the work space is shared between that disk and the system disk. In all other cases the work 
space is located entirely on the system disk. The named disk may be any type of disk applicable to the system 
in use. 


Examples 


To sort the system disk file INP.FILE using the key starting at character 5 of length 3 characters, creating 
a system disk file OUT.FILE: 


SORT FILE IN INP.FILE (DISK) OUT OUT.FILE (DISK) 
KEY (9 6) 


To create a keyfile OUTKEY.FILE on disk PR2 from a data file INP.FILE1 on disk PR2, using a 5-byte 
key starting at the first byte: 


SORT FILE IN PR2/INP.FILE1 (DISK) 
OUT PR2/OUTKEY.FILE (KEYFILE) 
KEY (1 10) 
INDEX 
COMMENT DUPLICATES NOT ALLOWED 


To merge the three system disk files FILE1, FILE2 and FILE3 into an output file MERGE.OUT: | 
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SORT 

FILE IN FILE1 (DISK) FILE2 (DISK) FILE3 (DISK) 
OUT MERGE.OUT (DISK) 

KEY (5 10) 

MERGE 


FUNCTIONAL DESCRIPTION 


The five functions of the sort are described here: 
Regular record sort. 
Inplace record sort. 
Keyfile creation. 
Tagfile creation. 
File merge. 


Regular Record Sort 


All the records contained within the specified input file are ordered using one or more keys. Deleted records 
(see later) are not included in the output file. See later for details of the keys. Refer to figure 5-1 for an example 
of a regular record sort, where the key is starting in byte 3 and is 5 characters long, and the sort is in ascending 
order. The X’s refer to any other characters. | 


The input file must be wholly contained on one hardware type, although it may be a multi-reel or dual-disk 
file. No other programs may write to this file during the execution of the sort. 


The sort uses non-overlayable memory during execution. The amount is calculated according to the input file 
and key sizes. The amount may be specified as a user option, in which case the specified amount is used unless 
it is less than enough for a successful sort. In the latter case the specified value will be overridden. 


The sort uses disk work space, of up to (2.2 times the size of the specified input file. For the location of 


the work disk space, refer to the WORKDISK user option (see earlier). This work space is returned to the 
system at end-of-job. 


Inplace Record Sort 


This is the same _as the regular record sort, except that the records are sorted within the input file. No new 


output file is created. The time taken is substantially greater than a regular sort, for the same input specifica- 


tions. If deleted records are present in the file before the sort, they are removed: hence the number of records 
in the file may decrease after it has been ordered. 


| The inplace sort uses non-overlayable memory during execution. The size of this area cannot be specified at 
janitiation. 


The input file must be on disk. No other programs may access this file during execution of the inplace sort. 
The output file must be the same as the file specified for input. 


If_a particular system does not implement an in-place sort, a regular sort will be performed instead. 


seamen 


-The_inplace sort uses disk work space, of [0.2 to 0.3 times|the size of the input file. When the input file is 


resident on a user disk, up to one-half of the work s 
> Y , pace is located on that disk, otherwise all 
located on the system disk. This work space is returned to the system at end-of-job. ei aid 


Keyfile Creation 


A new file (the “keyfile”) will be created containing one record for each record of the input file (the “‘data 
file”). The keyfile is sorted in order of the spécified keys, and each keyfile record contains the key and a pointer 
to the corresponding record in the data file. Any deleted records in the data file are not referenced in the key- 
file. Note that the records in the data file are not re-ordered and deleted records in the data file are not re- 
moved. Refer to figure 5-2 for an example of a keyfile creation, where the key is starting in byte 3 and is 5 


characters long, and the sort is in ascending order. The X’s refer to any other character. 


ins f? yee (FEE, 


Duplicate keys are not allowed unless specified (see the user-option statements DUPLICATES and NODUP- 
LICATES). If they occur, then the record number is displayed on the SPO for each such occurrence, and the 
sort will continue but the output keyfile will be purged at end-of-job. | 


_ The keyfile creation uses disk work space, of up to 2.2 times the size of temporary file created by the sort 
in this case. This file is large enough to contain one record with the key value and record number for each 
record in the input file. For the location of the work disk space, refer to the WORKDISK user option (see 


earlier). This work space is returned to the system at end-of-job. 


| (poor) 
Certain key values are not allowed during a keyfile creation. The key must not consist _of all binary zeroes, 


or must not contain any byte whose value is hex FF..If such a key is encountered, the record number is dis- 
played on the SPO, and the sort will continue but the output keyfile will not refer this record in the data file. 


Tagfile Creation 


A tagfile creation is similar to a keyfile creation, except that the output file contains only the record pointers, 
and not any key values. The tagfile records, however, are ordered in key value order, as specified by the sort. 
Any deleted records are not referenced in the tagfile. Refer to figure 5-3 for an example of a tagfile creation, 
corresponding to the keyfile creation in figure 5—2. 


A tagfile is a null keyfile. It is suitable for use as an ADDROUT file in RPG, and for limited indexed access 
in COBOL (the tagfile is read sequentially). 


% 


Disk space requirements are the same as for keyfile creation. ( Oy 6... , ase & } 


Merge 


The merge merges up to 16 input files, using one or more specified keys, producing one output file. Deleted 


records in the input files are not included in the output file. If there are duplicate keys values, the order in| 
which they are placed in the output file is given by the order in which the input files are specified. 


Each input file must be wholly contained on one hardware type, although it may be_a multi-reel_ or dual- 
disk file. No other programs may write to these files during the execution of the merge. 


Each input file must have the same record size and the same position and length for each key. Each file 
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must be already correctly ordered on the specified keys. If this is not the case, the merge will terminate prema- 
turely after displaying a message on the SPO. 


Refer to figure 5-4 for an example of a merge of two files, with a key starting at byte 3 which is 5 characters 
long. The X’s and Y’s refer to any character. 


The merge uses non-overlayable memory during execution. The size of this area cannot be specified at initia- 
tion: it will be approximately equal to the sum of the block sizes of the input files and the output file. 


ge does not use any disk work space. 
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Details Of Sort Keys 


A “key” is the field within each record that is used for sorting or merging. If several distinct field within 
a record are specified, then each field is a separate key. The relative order of importance of the keys is deter- 
mined by the order in which they are specified. Figure 5-5 illustrates this with a two-key sort, using the KEY 
statement. 


KEY (5 6 ALPHA) (15 2 DESCENDING ALPHA) 


The X’s indicate any character. In this example the three-byte field is the major key, sorted in ascending 
order: the one-byte key is a minor key sorted in descending order within the order of the major key. 


For all sorts except keyfile and tagfile creation, there can be up to 10 keys. The sum of the length of all 
keys (including signs) must be_a maximum of 29 bytes. 


The available key types are discussed here, under the keyword specified in the KEY statement (see earlier): 


ALPHA (or UA) 


Unsigned 8-bit_ alphanumeric field, conaining ordinary ASCII characters. Note that this may consist of the 


ey ane ern 


8-bit ASCII digits “0” to “9” but still be termed alphanumeric. This key type is the default. 


NUMERIC (or UN) 
Unsigned 4-bit numeric field, where each 4-bit unit is a binary coded decimal digit, 0000 to 1001 (0 to 9). 


SA 


- Signed 8-bit alphanumeric field. Each byte is an ordinary ASCII character (including the digits 0-9), except 
that either the first or the last character indicates the sign. Whether the sign is the first or last character_is 
specified by the keyword L (left) or R (right). The default is L (first character; leading sign). The convention 
for coding the sign character is given in Table 5-1. These characters are termed “‘overpunched signs’’ by anal- 
ogy with historical punched card systems. 


SN 
| Signed 4-bit numeric field. Each 4-bit unit is a binary-coded decimal digit, 0000 to 1001 (0 to 9), except that 
either the first or the last 4-bit unit indicates the sign. Whether the sign is the first or last 4-bit unit is specified 


by the keyword L (left) or R (right). The default is L (first 4-bit unit); leading sign . The convention for 
coding the sign is given in Table 5-2. 


SSA 
8-bit alphanumeric field with separate sign. Each byte is an ordinary. ASCII character (including the digits 
0 to 9), with the sign given by an ASCII character in either the first or last character. Whether the sign is 


given by the first or last character is specified by the keyword L (left) or R (right). The default is L (first 
character); leading sign . The convention for coding the sign character is given in Table 5-3. 


The position of a sign within a signed key (left or right) must be the same throughout all occurrences of the 
key. Signed keys are ordered so that negative values come before zero and positive values 


8-bit keys may start on 4-bit unit boundaries, unless the separate sign type (SSA) is used, or the key is to 
be used in keyfile or tagfile creation. 


Deleted Records 


A deleted record is denoted by every byte in the record (including the key) containing the value hex FF. 


The action taken by the vari t is di 
by the FS utility. y 10us sort options is discussed earlier. Deleted records may be physically removed 
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Output Messages 


Output messages cover warnings and errors. Messages are generated by both the sort intrinsic and the sort 
language processor. The intrinsic messages are numbered by event numbers in the same way as MCP output 
messages (see section ). The sort language processor messages are numbered in a similar way. 


Messages can be divided by number as follows: 
0-99 


Sort language processor messages, displayed on the printer. Such messages appearing in the list below that 
are followed by a series of dots (...) should be read with the phrase NEAR COL XXX (with XXX replaced 
by an appropriate column number) in place of the dots. 


0-34 
Warnings, where corrective action is attempted. 
35-39 | 
Warnings, where no corrective action is attempted. 
40-59 
Errors in syntax (that is, the format of the sort statements is incorrect). 
60-99 


Errors in semantics (that is, an inconsistency has been detected in the statements, such as a key position 
greater than the record size). 


170-200 


Sort intrinsic messages, displayed on the SPO. 
Certain messages may be suppressed by the NOPRINT and NODISPLAY keywords in the sort statements. 


The NOPRINT option suppresses listing of the sort statements on the printer by the sort language processor. 
If this option is set, a maximum of five errors and four warning messages are directed to the SPO, with only 
the error or warning number being given (no explanatory text). The NOPRRNT option has no affect on sort- 
intrinsic-generated messages. 


The NODISPLAY option suppresses display on the SPO of start-up and termination messages by the sort 
intrinsic. Messages in the list below that are marked with an asterisk (*) are those that are suppressed when 
this option is set. Note that it is not possible to suppress individual messages; every applicable message is sup- 
pressed if the option is set. The NODISPLAY option has no affect on sort language processor messages. 


Number Messadqe 


EXPECTED SLASH NOT FOUND» "“/" INSERTED o-«- 

EXTRA "FILE IN"... 

MERGE INTRINSIC IGNORES <WOIRK-OISK OPTION> 
OVERLENGTH PART OF <LABEL NAME> IGNOFEC ... 

INPLACE INTRINSIC IGNORES <WORK“DISK OPTION> 
EXPECTED BRACKET NOT FOUND» “<™ INSERTED 
<DUPLICATE OPTION> VALID IN INDE X"KEYFILE SORT ONLY 
EXPECTED BRACKET NOT FOUND>e >" INSERTED ... 
ILLEGAL TO DELETE INPUT FILE» <PURGE OPT> IGNORED 
GCUTPUT BUFFER SIZE TCO BIG» <BLECK FACTOR> REDUCED ... 
<USER OPTION> ALREADY INVOKED» LATEST USE o-- 


CO wDdnwn cd US w N pe Oo 


pos 
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Number Message 


11 MERGE <SORT TYPE OPTION> NOT SPECIFIED 
12 OVERLENGTH PART OF <DISK NAME> IGNORED .e- 
13 MISSING "FILE IN" see 
14 INDEX <SORT TYPE OPTION> NOT SPECIFIED 
15 EXTRA @KEY™ 2... 
16 <FILE SIZE OPT> VALID FOR MERGE/REGULAR SORT ONLY 
17 MISSSNG "KEY™ 2... 
18 INPLACE INTRINSIC IGNORES <MEMORY OPTICGN> 
19 <M“FILE/DP ID> IGNGRED ON NON“MACNETIC MEDIA FILE ..- 
20 NUMBER TOQ BIG» MAXIMUM VALUE ALLOWABLE ASSUMED ... 
21 not used 
22 <SIGN POSITION> GIVEN FOR UNSIGNED KEY .e- 
23 FIRST UNIT NUMBERED C RATHER THAN 1 wee 
24 <FILE SIZE OPT> IGNORED SINCE OUT OF RANGE ... 
25, MERGE INTRINSIC IGNORES <MEMORY CPTICN> 
26 <BLOCK FACTOR> OF O NOT ALLOWED» 1 ASSUMED ... 
27 IN ANC QUTYT"FILE RECORD SIZES MADE EQUAL 
28 <BLOCK FACTOR> TOO LARGE» MAXIMUM ASSUMED ... 
29 INPLACE SORT MUST HAVE IDENTICAL IN@= AND OUT“FILES 
35 IDENTICAL IN/OUT - FILES WILL PRODUCE QUPLICATE FILE 
36 NOT NECESSARY TO PURGE CARD FILE ... 
37 ALPHANUMERIC KEY DO£S NOT START SN BYTE BOUNDARY ... 
40 <KEY STATEMENT> ALREADY PROCESSED» NCW ... 
| <DIGIT STRING> EXPECTED ... 
42 <CHARACTER STRRNG> EXPECTED ... 
43 <SEPARATOR STRING> EXPECTED ... 
4 <RCRD“BLCK PAIR> MUST BE GIVEN FCR NON“DISK IN“FILE 
50 NO <FILE .STATEMENT> SPECIFIED 
51 ILLEGAL WORD ...- 
52 <LETTER STRING> EXPECTEO ... 
53 MISSING <LABLE NAME> 2. 
54 UNSUPPORTED <IN/OUT MEDIA> ... 
| 55 UNSUPPORTED <SORT TYPE OPTION> ... 
+56 PART OF <FILE STATEMENT> MISSING» NOW ... 
57 NO <KEY STATEMENT> SPECIFIED 
58 <FILE STATEMENT> ALREADY PROCESSED» NOW ... 
59 | FINAL STATEMENT INCOMPLETE .-. 
60 TOO MANY KEY SPECIFICATICNS ... 
61 TOO MANY FILE SPECIFICATIONS .-. 
62 INPUT FILES RECORD SIZES NOT IDENTICAL ... 
63 | <RECORD SIZE> GUT OF RANGE .-. 
64 EXTRA DIGITS IN. QVERLENGTH STRING IGNORED ... 
65 KEY LENGTH OUT OF RANGE .-. 
66 MIN LENGTH OF SN KEY IS. TWO 4*8IT UNITS 2.2. 
67 BUFFER SIZE TOGO LARGE .-. 
68 DUPLICATE <IN“FILE PARAMS>» LATEST INSTANCE ... 
69 | BUFFER SIZE TOO BIG FOR <IN/OQUT MEDIA> ee. 
70 ONLY ONE IN“FILE LEGAL FROM MULTIPLE TAPE ... 
71 MERGE INSTRINSIC NEEDS AT LEAST Z@ INFUT FILES 
72 INDEX PARAM MUST BE *0UT...<KEYFILE/TAGFILE>™ 
73 KEY OVER“RUNS RECORD BOUNDARY 
74 | ILLEGAL TO OQVERWRITE INPUT FILE WITH TAG/KEY FILE 
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Number Message 


75 ALPHANUMERIC KEY LENGTH NOT EVEN NUMBER OF 4“BITS eae 
76 <MECIA> MUST BE DISK FOR IN@PLACE SORT 
77 IN- AND OUT“FILE RECORD SIZES MUST BE IDENTICAL 
78 INDEX“KEYFILE KEY LENGTH NOT EVEN NUMBER OF 4G=BITS 
79 ONLY GNE KEY LEGAL IN INDEX“KEYFILE SORT 
80 INDEX“KEYFILE SORT KEY TCO LONG 
81 INDEX“KEYFILE SORT KEY MUST BE *.2.. A UASUN>™ 
82 ONLY INDEX SORT CAN SPECIFY "KEYFILE/TAGFILE* 
83 INCE X“KEYFILE SORT KEY MUST START ON BYTE BOUNDARY 
84 MIN LENGTH OF SSA KEY IS FOUR 4°BIT UNITS ... 
85 SSA KEY MUST START ON BYTE BOUNDARY ae. 
86 CURRENT SUM OF KEY LENGTHS OUT (GF RANGE ... 
170 DUPLICATE RECORD <record numter> 
171 ILLEGAL INCEX KEY IN RECECRO <record nurber> 
172 RECORDS LOST / GAINED BY SORT=MERGE 
173 <number> DUPLICATE RECORDS 
174 <number> RECORDS CONTAINING INVALID INDEX KEYS 
175* <number> DELETED RECORDS 
176* <number> RECORDS MERGED 
177* <number> FILES MERGED | 
178 SORT-MERGE OUTPUT FILE NOT CREATED 
179 SORT=MERGE ABNORMAL EOJ 
180 SORT@“MERGE SOFTWARE ERROR 
181* <number> RECORDS REFERENCED BY KEYFILE/TAGFILE 
182 NO INITIATING MESSAGE 
18 3* <number> RECORDS SORTED 
184 FILE ERROR <<number>> NEAR RECORD <record number> ON 
<file name> | 
185 UNORDERED MERGE INPUT FILE <file name> NEAR | 
RECORD <record number > 
186 TOG MANY RECORDS FOR SORT=MERGE 
187 DUPLICATE RECORCOS“KEYFILE NOT BUILT 
188 INITIATING MESSAGE INVALID 
189* SORT“MERGE VER xeyez INITIATED FROM <nix number>/ 
<program name> 
193 INPUT RECORD SI7ES UNEQUAL = BAD FILE <filename> 
194 IN/OUT RECORD SIZES BAD = OUTPUT SIZE CHANGED 
195 BAD RECORD/BLOCK SIZE FCR QUTPUT DEVICE 
196 KEY OVER|RUNS RECORD END 
197 CANNOT SPLIT INDEX FILE 
198 <number> PARITY BLOCKS 
199 INDEX INPUT FILE NOT TYPE DATA 


Message 184 represents differing file errors depending upon the value of <number>. Defined meanings are 
as follows: 


1 — EOF on output file 7 — output file error 
2 — parity on input file 8 — parity on sort workrfile 
3 — EOF on sort workfile 9 — parity on input file (block ignored) 


4 — parity on output file 
5 — sort workfile error 
6 — input file error 
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record 


| number 
X x11 9 5 2 Q]X X X 1 X X10 10 0 3;X X X 
X X11 0 0 3 5 x x Y 2 Xx X10 214 7|X X X 
x x 01003 Xx 3 Xx X11 0 0 3 SIX X X 
X X16 9 7 1 24X% XK X 4 xX X}1 0 03 O]X X X 
X X16 9 8 & 31X% X X 5 xX X11 05 2 O]X X X 
X X11 090 3 61X X X 6 XxX X13 24 0 OQ]X X X 
r ’ 3 24 0 Ox x X t Xx X16 9 7 1 2@{|X X X 
7 coer ae 8 X X16 9 B& 3X X X 
daca Aaa. oe data file 
input | output 
Figure 5-1. Regular Record Sort 
record 
number | 
X X11 05 2 O]K ’ ’ 1 03 }C 1 0 0 3 
x xf10035|x x» os foz2147 
X X10 1 0 0 3 ;xX X x 3 C2. 3 On 0 3.5 
X X16 9 7 1 2{XK X X 4 06/1090 3 6 
X X{6 9 8 4 3 X xX Xx 5 01 i 0 3 2 0 
X X/1 0 0 3 6]X X X 6 07 13 24 0 0 
x x]3.2 6 0 0|[x x » ? 04 le 9712 
- oe £7 xx X 8 > 6 o 8 - 
data file keyfite 
Input | cutput 


Figure 5-2. Keyfile Creation 
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105 2 0 


mm ee ee ae 


010 0 3 


69 7 1 2 


69 8 4& 3 


data file 
input 


record 
number 


1 


3 


tagfile. 
output 


Figure 5-3. Tagtfile Creation 
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Y Y 


Y Y 


Y Y 


Y Y 


Y Y 
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010 0 3 


105 2 90 


35324 9 0 


69712? 


69 8 4 3 


08 7 2 6 


10038 


20001 


4 21 6 8 


49137 


Y Y ¥ 


Y Y ¥ 


YY Y 


Y Y Y¥ 


YY Y 


o> an an es 


input fites 


Figure 5-4. File Merge 


0 0 3 5 


1003 6 


2c.hehl[U8l lh 


3240 0 


49137 


— a | 


output fite 


X X13 G6 4) XS IK x OL oe Mie en 
X X11 0 2)X X{&]X xX ewe Bale x eles 
X X19 f 3)X X13 ]X xX ale Se wees 
x xfo 2 0[x xl7|x 9 x x]3 6 alx xfalx x 
x xfs 0 2[x xJo|x » x x/36 4]x xisix x 
x x[3 6 ax xlalx x x xls 2 7|x xlolx x 
x x]s 2 7/x xlo]x x x xl6 3 olx xlolx x 
x x[6 3 o[x xlolx x x x]o 7 3|x x/3ix x 

data file data file 


input output 


Figure 5-5. Multiple Key Sort 


Table 5-1. Sign Convention For Signed 8-Bit Alphanumeric Fields 


Key Value Hex Code ASCII Character 
-( 2D ~ 
-¢C 70 “ 
+0 30 0 
+0 7B _ 
=~ LA J 
“2 4B K 
=% 4C L 
“4 4D Mo 
=5 4E N 
“6 4a F 0 
-7 5C p 
be & 51 Q 
-9 52 R 
+1 31 1 
+2 32 2 
+3 33 3 
+h 34 4 
+5 35 5 
+6 36 6 
+7 37 7 
+8 38 8 
#§ 39 9 


Note? any other hex code in the sign character is interpreted as 
positives with the key vatue given by the binary vatue of the 
righthand 4 bits of the character. 
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Table 5-2. Sign Convention For Signed 4-Bit Numeric Fields 


Key vatue Binary Code (BCD character) 
negative 0101 5) 

positive 0011 (3) 

Note: any vatue other than 0101 (5) jis 
interpreted as positive. 


Table 5—3. Sign Convention for Separate Sign Character with 8-bit Alphanumeric Fields 


Key value ASCI! character Chex vatue) 
negative men €20) 
positive wer (28) 


Note? any character other than """ is interpreted 
as positive. 


5-18 


SECTION 6 
COMPILATION FACILITIES 


INTRODUCTION 


Compilation of programs written in CMS COBOL, RPG and MPL can be performed with the CO (compile) 
utility. CO is a normal utility program residing on disk. It is used to co-ordinate the various parts of the CMS 
COBOL, RPG and MPL compilers. Each compiler consists of several object code files (called ‘“‘passes’’) and 
produces a number of workfiles to pass information between each pass. The CO utility allows initial input to 
be made to the compiler by specifying such things as input and output file names. 


Additionally, CO allows multiple executions of each compiler by storing compiler workfile information in a 
master file called CO.MASTER on the system disk. The compiler passes have access to the information in this 
disk file. Information in this file also allows the CO utility to perform restarts if the system halts during a compi- 
latin. This restart facility eliminates the need to rerun a eee from pass one if one or more passes have 
already completed successfully. , 


CO uses some standard names for input and output files, which can be changed by the inital CO message. 
The basic CO operation is given in Figure 6-1. 


Initial input to CO is either from the initiating SPO message or through macro (star) files or through a disk 
file called ‘CO.STARTUP” on the system disk. CO generates the CO.MASTER file used to co-ordinate the 


compiler passes. There is an option to produce a CO listing. Information provided to CO enables the user to 
describe the following: 


input patch file 

input source file 

output source file 

output object program 
output compilation listing 
compiler workfiles 
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INITIATING MESSAGE 


CO.MASTER 
STAR FILES ) 
. DISK) 
(DISK) co 
UTILITY 
CO.STARTUP 
(DISK) aT 


CO 
LISTING 
(PRINTER) COMPILER 
PASSES 


COMPILER 
WORKFILES 
(DISK) 


PATCHFILE 


(DISK) 


SOURCEIN 
(DISK) 


COMPILATION 
LISTING 


(PRINTER) 
SOURCEOUT 
(DISK) 


OBJECT 
PROGRAM 
(DISK) 


Figure 6-1. Operation Of CO Utility 


CO provides the ability to set “dollar options” for the compilation. 


CO operates in two basic ways 


to initiate and control a single compilation. 
to interrogate compilation status, and restart or clear an aborted compilation. 
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TO INITIATE A SINGLE COMPILATION 


Format: 
| disk-name / | object-program name | disk-name / compiler-name 
| compiler-option | PRINT file-statement | MESSAGE text 


CO 


This initial input can be entered on the SPO when executing CO. CO _can also be started with no_ additional | 
information from the SPO: in this case the information is either on a card file or on a disk file called “CO. STA- 


Pa = neni eae ana acai 


SRN EO ERR MRA CE ETNA RNR RENE PITH FY MER 


RTUP” on the system disk. Selected parts of the input can be provided as star files see later in this section. 
All disk files used for inputting information to CO can be 80 byte card-image records created by CMS CANDE 
or CREATE, with all information in the first_8 records and the first 72 characters of each record. 


Semi-colons may separate any clauses after the compiler-option, for readability. 


The object-program-name is optional. If not specified, it will be created on the system disk with a name as 
follows: 


“COBOBJECT” - for COBOL compilations 
“RPGOBJECT” — for RPG compilations 
“MPLOBJECT” - for MPL compilations 


The name of the disk for the generated object program may also be specified. If not specified, the system 
disk is assumed. 


The compiler-name may be one of the following: 
COBOL - the COBOL compiler 
RPG - the RPG compiler 
MPL —- the MPL compiler 
RPGXREF - the separate RPG cross-reference program 
~~*“OPTLIST —- the separate COBOL/RPG optimizer 


If the optional disk-name is - given before the compiler-name, then the compiler may be executed from a user 


disk so long as all passes are on the specified disk. If no disk name is given then the compiler must be on 
the system. 


The compiler-option may be one of the following: 
SYNTAX (abbreviation SY) 
LIBRARY (abbreviation LI) 
GO (alternative SAVE) 


With a “compile for syntax‘‘, no object program is generated. For COBOL and RPG, COBSVERTER is 


aE DELBAERE 


not executed, for MPL, the compilation stops at the end of pass 3. 
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With a ‘“‘compile to library’, an executable object program is created if there are no syntax errors, and saved 


psec tse ta tear a ember arc SPREE SA SS BSR AE SIRE EE A sana 


on disk with the object-name as specified in the CO statement. A compile to library is the default compiler- 
option. 


A “compile and go” is the same as a compile to library, with the additional feature that the object program 
is executed. The CO _utility goes to EOJ after zipping the object program. 


If the PRINT option is specified, an edited listing of the startup message is output, along with a list of settings 


RI ATS ENP P RARE SEI RRO PARTISAN SEN OR SEA POLIS EATS Bt PES EEG LI ELA TL NON ER MEISE 


for all the file parameters which are modifiable through CO. A list of default dollar card settings for the compil- 


IEEE it ESSN te ES MAUI STOMA ES OSEAN 


ation is output along with any dollar options entered via_ the CO. “message. ‘This object listing also contains a 


log of all error messages displayed. 


The file statements allow names and other attributes to be set for the compiler input and output files. The 
general form of these statements are given here, but not all attributes may be set for all files these will be dis- 
cussed in turn. 


Format: 
. NAME. disk-name / file-name 
MFID disk-name 
PATCHFILE FID file-name 
SOURCEIN DEVICE hardware-type 
s SOU RCEOUT RECORD number 
Ie WORKFILE BLOCK number 
PRINTOUT RECORDS.BLOCK number 


FILESIZE number 
FILE.SIZE number 


The meaning of the file attributes are as follows: 


NAME 
This specifies the CMS file name plus disk name and may be of the form MFID/FID. 


MFID 
This specifies the disk name of the given file. The default is the system disk. The MFID must be a maximum 
of 7 characters. 

FID 


This specifies the file name of the given file. The default is the system disk. The FID must be a maximum 
of 12 characters. 


(Note: FID and MFID may be used together, or NAME may be used instead of the MFID/FID combination). 


DEVICE 


This specifies the type of peripheral of the input or output file. The default for the PRINTOUT file is line 


printer. The default for all other files is any disk. The device is specified by a 2-character mnemonic as fol- 
lows: 


FILESIZE 


card readers: 


any card reader 
any multifunction unit 


8Q-column 
EC*cotumn 
96-coluUMmn 
936"cotumn 
card punches: 


reader 
reader/punch 
reader 
reader/punch 


any card punch 
any multi-function unit 


&cecolumn 
80"cotumn 
96°colUMnN 
$6“cotlumn 


punch 
reader/punch 
punch 
reader/punch 


tapes and cassettes (NRZ or PE) 


any tape 


write-disSabled reel 
write"disabtled cassette 


Caltenatvies: 
Note: if a writesdisablec cevice 
for an output file>, 
writesenableda device 


issue warningee. 


orinters: 


any printer 


Serial printer (console) 


Line printer 


disks? 
any disk» 


default catridge 
DC » 


Calternatives: 


Burroughs 


Fixed disk 


pack 


Super Mini 


CS» 


CASSETTE) 


is specified 


CO will sutstitute a 
in the specifications 


AP 
LP (A) 


DK 
DM 


DF 
DP 


and 


This attribute specifies the maximum number of records in the output file. If used with PATCHFILE, the 
number specifies the total number of source lines to be compiled, including dollar cards and “‘COPY state- 
ments” in the case of COBOL compilation. The number may be followed by the letter K to denote thousands. 
For example, the statement | 


FI SOURCEOUT FILESIZE 4 K 
specifies a filesize of 4000 records. A space must separate the “K” from the number. 
An alternative spelling of the keyword is “FILE.SIZE”’. 


The files 


PATCHFILE 


are as follows: 


This is the primary source input file, and contains dollar records and source records which may optionally 
be merged with a secondary input file to produce an output source file. Attributes which may be set, and 
their default values are: | 
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NAME 

MF ID 

FIO 
DEVICE 
FILESTZE 


PATCHFILE 
system disk €0000000) 
PATCHFILE | 


DK 
0 
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SOURCEIN — 


This is the optional secondary input file. Attributes which may be set, and their default values, are: 


NAME. SOURCEIN 

MF ID system disk €0000000) 
FID SOURCEIN 

DEVICE OK 


SOURCEOUT 


This is the optional source output file produced by merging PATCHFILE and SOURCEIN. Attributes which 
may be set, and their default values, are: 


NAME SOURCE OUT 

MFID system disk (€0000000) 
FIO SOURCECUT 

DEVICE DK 

FILESIZE & K 

RECORD 80 

RECORDS.BLOCK 9 

BLOCK {20 for aisks 


240 for Cassettes 
2000 for magnetic tares 


WORKFILE 


This refers to the intermediate workfiles produced by the compiler during the compilation. The only attribute 
that can be specified, and its default, is: 


MFID system disk (9000000) 


PRINTOUT 


This refers to the listings produced by the various compiler passes during the compilation. The only attribute 
that can be specified, and its default, is: 


DEVICE LP 


The MESSAGE statement 


The reserved word MESSAGE indicates the start of the list of dollar options for that compile. The text con- 
sists of a list of one or more dollar cards, taken from the list given below, separated by spaces. 


For example, for an MPL compilation the following would be valid: 
MESSAGE $LIST $XMAP $SEGMENT FR20 
Use of this feature is not valid for COBOL compilations. 


Examples: 


To compile the COBOL source program AR678S, and create the object program AR678, both on the system 
disk: 


CO AR678 COBOL LI FI PATCHFILE FID AR678S 
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To merge the RPG patch file ROQ20P with the source file RQ20S, and create a new source RQ20SN and 
object RQZO0NEW, all on disk RDEV: 


CO RDEV RQ20NEW RPG LI; FI PATCHFILE NAME RDEV/RQ20P; 
FI SOURCEIN NAME RDEV/RQ20S; FI SOURCEOUT NAME 
RDEV/RQ20SN; MESSAGE $MERGE 


To compile the MPL source program MTEST.S from the disk USR1 to produce object MTEST on disk 
USR1, with CO listing, and compiler listing on the console: 


CO USR1 MTEST MPL LI; FI PATCHFILE NAME USRI/MTEST.S; 


ors aass ere ils 


To compile source PATCHFILE with COBOL and create object COBOBJECT on the system disk: 
CO COBOL 


To patch COBOL source CS500 (found on tape) with cardfile CRDPATCH and produce an object program 
CNEW on disk F1, putting compiler workfiles on disk FSCRATCH: 


CO FI/CNEW COBOL LI; 

FI PATCHFILE FID CRDPATCH DEVICE AR; 
FI SOURCEIN FID CS500 DEVICE AT; 

FI WORKFILE MFID FSCRATCH; 
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USE OF MACRO CALLS 


All or part of the initiating message to CO may be provided as data in disk files. This is indicated by an 
asterisk (star) in the message. 


Following the asterisk must be a valid file name, including the disk-name if not on the system disk. When 
the initiating message is scanned, the contents of a star-file are included in the scan. At the end of the star- 
file contents, scanning continues with the primary message. The complete initiating message, or individual 


clauses, may be included in the star-files. The message format for CO has been repeated below with an asterisk 
where a Star-file may be used: | 


| disk-name / object-program name 
: compiler-option | . PRINT 


Example: 


Format: 


CO + 


o | disk-name / compiler-name 
| * file-statement : | MESSAGE text 


Consider four star-files, with names and contents as follows: 


nane contents 
FILE AA RPG GC 
FILE? PATCKFILE NAPE BB 
FILE CEVICE Ak 
FILES SOURCEDUT FID CC. 


Then the following two initiating messages to CO are valid: 
CO *FILEI PRINT *FILE2 DEVICE AR 
CO *FILE1 PRINT *FILE2 *FILE4 


but the following two messages are invalid, because the contents of FILE3 is wrong, as it starts in the middle 
of a file-statement: 


CO *FILE1 PRINT #*FILE2 *FILE3 
CO *FILE1 PRINT PATCHFILE NAME BB *FILE3 
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COMPILER DOLLAR OPTIONS 


In the following list, (D) indicates the options which are set by default. This notation is also used in the output 
listing from CO, to distinguish default settings from deliberate dollar card settings. 


For COBOL, no dollar options may be set or reset by CO. For a fuller description of the available RPG 
and MPL options, consult the relevent compiler manual. 


RPG 

$ LIST (D) $ NLIST 
$ SEC $ NSEQ 

$ XMAP $ NXMAP 
$ SUPR $ NSUPR 
$ LOGIC $ NLOGIC 
$ MERGE f NMERGE 
$ SEVERE (D) $ NSE VERE 
$ MAP ¢ NMAP 

$ NAMES $ NNAMES 
$ NEW $ NNEW 


Any RPG dollar options specified in the startup message for CO will override any occurrences of that option 
appearing in either the PATCHFILE or SOURCEIN input files. 


MPL 
$ LIST $ COOE 
$ NOLIST $ NEWTAPE 
$ LISTE $ FORMAT 
$ LISTP $ SEGMENT filename 
$ SEGUENCE f SEGSIZE integer 
$$ XMAP 
$ NOWARNING 


Any MPL dollar options specified through CO are used only as initial settings, and may be overridden by 
dollar cards appearing in either of the source input files. 
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TO INTERROGATE THE STATUS OF COMPILATIONS 


CO may be used to determine the status of any compilations. This is done by interrogating the CO.MASTER 
file. The message is: 


CO MX 


This function may be used at any time, provided that the mix is not already full. It yields information in 
the following form: 


CO MIXNUMBER n 
COMPILER NAME compiler-name 
CURRENT COMPILER PASS compiler pass name 
PROGRAM NAME object~file-name 
WORKFILE CHARACTER TA | 


(where “‘A” is a character used by CO in the meaning of workfiles so that different compilations can precede 
with separate workfiles). In addition to the above information, if a compilation is either awaiting Restart or 
Clear (see later), or has been Restarted but has not yet gone to end-of-job, the following will be displayed: 


(THIS CO IS IN RESTART MODE) 
Note that the “CO MX” function will give information about all current compilations marked in the 


CO.MASTER file, even if they were prematurely stopped by a system failure. This is different from the MCP 
“MX” intrinsic, which will only give the jobs currently in the multiprogramming mix. 
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TO RESTART AN ABORTED COMPILATION 


This function may be used to restart a compilation which has been terminated prematurely due to a system 
failure such as a clear start or ZIP failure. The message is: 


Format: 


CO RESTART | mix-number | line-number 


If only one compilation was being done, then the simple message 
CO RESTART 


is sufficient. The compilation is resumed at the beginning of the pass in which the failure occurred. If more 
than one compilation was being done, the mix-number must be supplied, which is the mix-number of the 


particular CO that was running at the time of failure. This number is determined either from the SPO log, or 
the CO MX facility. 


If the failure occurred during the printing phase of a COBOL compilation (pass COBOL7), then this pass 


can be restarted at a specified line-number. The line number must be in the range 000000 to 065535. For exam- 
ple, the message 


CO RESTART 2 010000 


i000" 


Once a RESTART has been initiated, no new compilations can be started until the restarted compilation has 
gone to normal EOJ. If that is not possible, for instance because a file is not present, then the restarted job 
should be CLEARed (see later) to allow other compilations to be initiated. 


Other CO versions executing are undisturbed by a RESTART operation. 


When a restarted job terminates, whether naturally or as a result of a CLEAR (see later), the message 
“RESTART COMPLETED” 


is displayed on the SPO. If a new CO, having the same mix-number as the one that failed, is started up 
before the failed CO can be restarted or cleared, then the block of information in CO.MASTER for the failed 
CO is lost and that compilation cannot be restarted. In this case the followwng message is displayed: 


“CO MIX-NUMBER n CANNOT NOW BE RESTARTED 
COMPILATION BLOCK RE-USED”. 
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TO CLEAR AN ABORTED COMPILATION 


If a clear start or other failure has occurred, and it is decided not to Restart compilations, then on or all 
of the compilations may be cleared. References to one or all of the compilations are deleted from the 
CO.MASTER file, and workfiles belonging to the compilation are removed unless the compiler requested that 
they be saved. The message is: 


‘Format: 


mix-number 
CO CLEAR ALL 


Providing a mix-number clears only the compilation whose controlling CO had the specified mix-number. The 
keyword ALL clears all compilations known to CO. If only one compilation was being done, then the simple 
message 


CO CLEAR 
is sufficient. 
Other CO versions executing are undisturbed by a CLEAR operation. 
Any CO can be CLEARed at any time whether or not a restart is in operation or pending. 
Example of aborted compilation: 
Assume that a system failure occurred while doing a COBOL compilation. The controlling CO had a mix- 
number of 6 and the compiler was in the OPTLIST pass. Assume also that, since the failure, an RPG 


compilation had been initiated. 


The message 
CO MX 


may result in the following information: 


CO wIx NUMBER 4 
COMPILER NAME RPG 
CURRENT COMPILER PASS RPGPHASE 
WORKFILE CHARACTER D 

CO MIX NUMBER 6 
COMPILER NAME | COBOL 
CURRENT COMPILER PASS OPILIST 
WORKFFLE CHARACTER C 


CTHIS COQ IS IN RESTART MODE) 


Then to restart the COBOL compilation, enter 
CO RESTART 6 


to cause the compilation to start at the beginning of OPTLIST. If the COBOL compilation is not required 
to be restarted, then enter 


CO CLEAR 6 


Note that in both cases the RPG compilation is unaffected. 
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ZIP FAILURES 


If a zip failure occurs, or a particular compiler pass is DS’ed or DP’ed, CO displays one of the messages 
in table 6-1 indicating the reason for the failure, then takes one of the following two actions: 


If no Restart is in operation or pending. 
One of the following messages is displayed: 
‘CO SHOULD BE RESTARTED OR CLEARED“. 
‘CO MIX-NUMBER n MUST BE RESTARTED OR CLEARED". 


The CO utility is forced into “Restart mode” which prevents any new COs or any other RESTARTS 
being performed until the CO in question has been either restarted and completed, or cleared. 


If a Restart is in operation or pending. 
One of the following messages is displayed: 
“CO SHOULD BE RESTARTED OR CLEARED” 
“CO MIX-NUMBER SHOULD BE RESTARTED WHEN 
EXISTING RESTART COMPLETE”. 


The CO utility is not forced into “Restart mode” in this case. It is required to RESTART the job as 
soon as possible after the existing restart is complete. 


Table 6—1, Zip Failure Messages 


ZIP FAILURE DUE TO PROGRAM FILE NOT FOUND FOR progr am~name 
Z1P FAILURE DUE TO INTERPRETER FILE NCT FOUNC FOR program=name 
ZIP FAILURE DUE TO NO MEMORY FOR program-neme 

7IP FAILURE DUE TO NO USER DISK FOR program"name 

ZIP FAILURE DUE TO MIX FULL FOR program=name 

ZIP FAILURE DUE TO USER COUNT ERROR progran“rame 

ZIP FAILURE DUE TO DUPLICATE PACK program"name 

7IP FAILURE DUE TO INVALID LOAD RECUEST program=name 

ZIP FAILURE DUE TG MCS ALREADY PRESENT procram=name 

ZIF FAILURE DUE TO DISK ERROR program*name 

ZIP FAILURE DUE TO CODE FILE ERROR program=neme 

7IP FAILURE DUE TO ILLEGAL DATA REGUEST program=name 

ZIP FAILURE DUE TO REASON UNKNOWN program=name 

COMPILER PASS DSted program"nafe 
COMPILER PASS DP*ed program=name 
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-RESERVED WORDS 


All keywords used in initiating messages to CO are reserved words; that is, they cannot be used for file names 
or other user-defined parts of the initiating message. A complete list of the reserved words is given in table 
6-2. | 


Table 6—2. CO Reserved Words 


MPL SOURCEOUT 
COBOL WORKFILE 
RPG PRINTOUT 
RPG XREF NAME 
OPTLIST MFID 
FID 
DEVICE 
FILE.~SIZE 
FILESIZE 
LIBRARY RECORD 
LI BLOCK 
PRINT RECORDS.~BLOCK 
MESSAGE | MX 
FILE RESTART 
FI CLEAR 
PATCHFILE ALL 
SOURCEIN 
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ERROR MESSAGES 


The printout file for CO may contain error messages from the CO utility itself. These are listed in table 6- 
3, and are largely self-explanatory. 
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Téble.6—3. Error Messages from CO 


ERROR MESSAGE 


First word in Initiating Message is not a valic disk or file 
name. 

Invatid object program name or compiler rame scecified- 
Warning = Compiler Pack Id- truncateoc to 7 characters. 
No compiler specified. | 
Warning ™ FProgram Pack Id. truncated to 7 chérecters. 
Warning = Program Id. truncated to 12 characters. 
Reserved Worc not found when expected. 

FI/FILE not followed by one of PATCHFILE» SOULRCEIN>» 
SQURCEOQUTs WORKFILE» PRINTCUT. 

Reserved Worc used out of Context. 

Warning = Compiler Option already mocified = previous 
mod-s ignored. 

Warning = Print Option specified more than orce. 

Record size * Blocking factor > 65535» 8tock size set equal 
to Record size. | 
MESSAGE not used by COBOL - Message Text ignored. 
Warning = Message Text atready processed 7 this 

Message Text ignored. 

This dottlar option may not be Set/Keset via the 

Compile Utility. 

$SEGMENT filename parameter not a valid file name. 
CO.MASTER no longer on disk - jot terminted. 

Warning = S$SEGMENT packwid truncated to 7 characters. 
Warning = £SEGMENT program"name truncateo to 12 characters. 
S$SEGSIZE parameter not numeric. 

Modification not vatid for SOURCEIN = modification ignored. 
Warning = MESSAGE contains no vatlic dotl@ér cards. 
warning ~ Scard not valid for this compiler. 

Warning - Invatid fteard in Message Text. 

Warning - PATCHFILE modifications already dore ~ these 
mods ignored. 

Warning = PATCHFILE modifications incomplete. 
Modification not vatid for PATCHFILE = mocificeéetion 
ignored. 

Warning ~ No PATCHFILE modifications. ? 
MFIC/FID modification atready cone for this file ~ 

tod ignored. 

Pack name/File name in NAME specificétion invalid. 

Pack name in NAME Specification truncated to 7 
characters- 
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32 File name in NAME specification truncatec to 12 
characters. 


32 Pack name in MFID clause invatid. 

34 Pack name in MFID clause truncated to / charécters- 

35 File name in FID clause invalid. 

36 File name in FID clause truncated to 1i2 characters. 

37 RECORD size of zero specifiec = mod ignored = cefauit 
used. 


38 DEVICE modification atready done for this file - this 
modification ignored. 

39 Specified Device Type invalid ~ default device type used. 

40 FILESIZE already modified for this file = this mod tgnored- 

41 FILESIZE parameter not numeric. 

42 BLOCK size etready modified - this mod. ignored. 

42 RECORDS.~BLOCK/BLOCK parameter not nuferic-. 

4&4 RECORD parameter not numeric. 

45 SOURCEIN modification atready done = these mods ignored. 

4&6 Warning = SOURCEIN modification Incomplete. 

47 No SQURCEIN modifications. 

4&8 SOURCEQUT modifications already done = these mcds ignored. 

49 Warning = SOURCEQUT modifications incomplete. 

50 Warning 7 No SOURCEOUT modifications. 

51 Specified RESTART mix*number not numeric. 

52 Specified mix-number out of range. 

52 Cannot initiate another RESTART - previous RESTART incomplete 

54 No CO with specified mix=number available for RESTART. 

55 Nuit Initiating Message 7 no file CO.STARTUP - job terrinated 

56 Nested Macro Cali found. 


57 Invalid file name in Macro Cail. 

58 Pack name in Macro Catl truncated to 7/7 characters. 

59 File name in Macro Call truncatec to 12 characters. 

60 Record size for card device > 96» RECORD and BLOCK size 
Set to 96. | 


61 Fite CO.STARTUP empty 7* No Initiating Message = job 
terminated. 

62 Cannot run CO on this systems SYSTEM STATUS Communicate 
not supported. 

63 CO.MASTER not found = job terminated. 


64 Compiler not zipped - errors in Initiating Message. 
65 Specified CLEAR mix“number not numeric. 
66 Specified CLEAR mix-number out of range. 


67 No COts to RESTART/CLEAR = job terminated. 
68 No CO with specified mix“number évaitable for Clearing. 
69 SYSTEM STATUS Communicate failure - job terminated. 
70 WORKFILE modification already done = this moc ignored. 
71 WORKFILE not fotlowed by MFID = mod ignored. | 
72 Specified RESTART tinesnumber for Listing not numeric. 
13 Specified Restart Linesnmber > 65535 = Line =number 

Set to 0. 
74 RESTART mix*number not specified. 
75 No parameter specified for CLEAR function. 
76 Line"*number parameter only vatid for COBOL = ignored. 
77 «=©636(6[kttegat character encountered in Initiating Message. 
78 Cannot continue compilation - Compilation Block 
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initialized. 

Noninput Device specified for PATCHFILE ~ mod- ignored. 
Non-input Device specifid for SOURCEIN - mod. ignored. 
Macro file not found - <file=“name> 


Non*outout Device specified for SOURCENDUT - moc ignored. 
BLOCK size for SOQURCEOUT is not a2 multiple of the | 
RECORD siZe. 

Specified BLOCK size for Tape Device too large = default 
value used. 

Specified RECORD size for Tape Device too large *- default 
used. 

80 col card device RECORD size > 80» RECCRD anc BLOCK 
size set to 80. 


96 col card device RECORD size > 96» RECORD anc BLOCK 


size set to $6. 

Warning = PRINTOUT modification already done - this 

mod ignored. | 

Device specified for PRINTOUT not Printer Type = ignored. 
PRINTOUT not fotlowed by DEVICE - mod. icnored. 

BLOCK size or Blocking"factor of ze@ro specifiec = default 
used. 

SOURCEDUT FILESIZE specified as zero = mode ignored = default 
used. 

Specified PATCHFILE FILESIZE > 65525 = default vatue used. 
Specified SOURCEOUT filesize > 65525 = default value used. 
Specified RECORD size > 65535 = default value used. 
Specified BLOCK size or Blocking*Factor >» 65535 * default 
used. 

When compiling MPL on Cumbernauld Support System» level 
number required. 

If 80 Col- card output device used» record truncation wilt 
occur. 

RECORD size already modified ~ this mod- tgnored. 

Macro file present but empty ~- <file-name> 
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RESTARTING EXECUTING CO VERSIONS 


Note that CO does not prevent restarting or clearing a currently-executing compilation. However, when the 
original version of the compiler pass, that was executing when the RESTART was done, terminates and returns 
to CO, CO will recognize that the block of information in the CO.MASTER file has been overwritten. The 
message | 

“CANNOT CONTINUE COMPILATION-COMPILATION 


BLOCK INITIALIZED” 
is displayed and the job is terminated. This may result in problems such as the occurrence of duplicate files. 
If an executing compilation is CLEARed, there is an added complication that any workfiles for that compilation 
are removed. | 


Restarting or clearing any currently-executing compilation is therefore not advised. 
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SECTION 7 
NUMBERED SYSTEM SOFTWARE 
OUTPUT MESSAGES 


INTRODUCTION 


The CMS software maintains a table of output messages used by the MCP, the interpreters, and other items 
like the SORT intrinsic. Each of these messages is given a number called the “event number’. The event num- 
ber is always displayed, enclosed in brackets, as part of the message. 


This section lists each message in event number order. 
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EVENTS # 1-9 
Software Information 


These are information indicating error conditions. If any action is required, other message(s) will follow imme: 
diately. 


Message format: 


mix number/program-name <EVENT #> file-name peripheral function message ERROR WHILE IN verb 
status. 


The peripheral is given by the mnemonic for example, DK for disk. The function is INPUT or OUTPUT. 
The message is given in the table below. The verb is OPEN, CLOSE, READ, WRITE, etc. The status gives 
additional information such as the disk address for disk failures. 


Examples: 


12/PD <46> MYDISK/SYSMEM DM OUTPUT TIMEOUT ERROR 
... WHILE IN OPEN 0033 | 


10/MYPROG <2> FR203D DM READ PARITY ERROR 
.».» WHILE IN READ 14A5 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


TAPE FORMAT Ending Label on tab- None. Program has 
etled tape is missina indicated it can 
or invalid. handle the error 

itself. 


PARITY Hard parity error Nonee Frogram has indic™ 
<STATUS> found on this ated it can handle 
device. the error itself. 
<STATUS> shows disk se 
ctor address for disk 
errors. | 


TIMEOUT | For tape device» no None- Program has 
<STATUS> data was found for indicated it can 
quite a distance on handte the error 
tape Cexact Length itself. 
depends upon unit); <STATUS> shows disk 
For diSks cylinder cytinder adiress for 
specified could cisk errors. 
not be used. 


ADDRESS Sector could not be None. Frogram has 


<STATUS> found on disk (cyt indicated it can handle 
inder was found). the error itself. 
Either software has <STATUS> shows disk 
indicated an invalid sector address for 
sector or sector disk errors. 
address on disk is 
corrupt. 


EVENT MESSAGE POSSIBLE CAUGES SUGGESTED ACTION 


REWIND Problem encount* Retry the program. 
ered on tape re 
wind. 


DESCRIPTOR Identifies I/G error None. Program has 
that is not PARITY» indicated it can 
TIMEOUT» ADDRESS or handte the error 
REWIND. itself. 


NON-F ILE It iS possible for Run SQ utility and 
FULL ON ath entries in avail* then retry the program. 
MF IO able table (non-file 

directory) to be in 

use. If a file then 

releases its disk 

space it may not be 

possible to enter it 

in the non-fite 

directory. Disk is 

checkerboarded. 


DEVICE LOCKED A non disk device 
is closed with lock. 


DEVICE NOT An attempt is made to 

P URGED close purge a write 
Gisable magnetic tape 
Grive@e 
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EVENTS # 10-19 
Software Suspensions 


When a program that is running encounters a condition that prevents it from continuing, MCP will suspend 
the program and inform the operator as to the reason for the suspension. When the condition is cleared, MCP 
will normally allow program to continue running. If program does not continue automatically then the operator 
should issue a “GO” command (see “GO” intrinsic) to the program. 


Message formats: 
mix number/program-name <EVENT #> WAITING file-name device message 


Examples: 


10/LIST <17> WAITING UNLAB LISTPRT AP NO FILE 
10/COPY <17> WAITING TL REEL 001 AT NO FILE 
02/NGD03 <12> WAITING FILE 255 NO USER DISK 
0O5/MPL.SEG <10> WAITING CARDFL DF NO FILE 


SUGGESTED ACTION 


MESSAGE 


POSSIBLE CAUSES 


10 NO FILE 


DUPLICATE 
FILE 


NO USER 
DISK 


Disk or tape file 
this program needs 
to use cannot be 
found. 


While attempting 

to place a certain 
file on disk» program 
has discovered a file 
with the same name 
aiready exists on 
disk. Program halts» 
ag 2 files with same 
name cannot reside on 
one disk-e 


There 1S no more 
availabDle space 
on disks or space 
available is 


Check for correct 
disk or tape» 
Supply program with 
backup copy of file 
requested, 


Program witl continue 
when file is supplied. 


Normally remove with 
RM the existing file 
from disk. Program 
will continue. If 

in doubt refer to 
program instruct” 
10Nns. 


With KA» analyze 


amount of available 


Space remaining. 


If disk 1s filled 


remove with RM any 
unnecessary files 
program 1s attempt and program will 
ing to writes or cont inue?> 

disk is “checker>- or 

boarded”. 


insufficient to 
hold fite this 


1—4 


14 


15 


| 16 
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DIRECTORY 
FULL 


MESSAGE > 


NO USER DISK (cont'd) 


DEWICE 
NOT AVAILABLE 


FORMS 


REQUIRED 


GENERATION 
NUMBER 
MISMATCH 


POSSIBLE CAUSES SUGGESTED ACTION 


If disk ts filted and 
a dualwnack file is 
desired» assign 
different disk to this 
program (see AD 
intrinsic)», or 

if disk is checker 
toarced use SQ ut“ 
ility to consolidate 
disk space» then re 
execute program that 
encountered suspension. 


When the disk was Remove with RM any 


initialized the disk unnecessary files and 
directory was const” program will continue? 
ructed to Contain a or DS the suspended 
fixed number of file programe Rentace disk 
names-e The directory with another dtsk 

has now reached its having sufficient dir- 
Capacity. ectory space» and re- 


execute the erogram. 


Output device that RY required device» 
program needs in order or assign program 
to.cContinue orocessing to alternate device 
is either unavailable (see AD intrinsic). 
or not ready. 7 


Program is waiting Insert correct forms 
for operator to Insert into output device. 

correct forms into the Then use “AD™ intrinsic 
outout device before to assign device to | 
it wilt continue pro program (see AD intrin= 
cessing. s1C). 


While opening an old 
indexed files» a dis= 
crepancy has been 
found between the 
gener ation number 
fields of the keyfile 
and the data file. 
The operating system 
will cancel the 
suspension when the 
discrepancy no longer 
exists. 
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EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


NO FILE Progr am needs a RY required device; 
device that is either or altow program 
unavailable» busy» — currently using the 
or not ready. device to go to éEnd 

of Joo and suspended 
program will then aut: 
omatically be able to 
use devices 


DUPLICATE 2 oor more disks Check for correct 
FILE Cor tapes) having disk or tape. 
| the same names have Replace Cor relabel) 
been found online. one of the duplicates. 


Onty one disk (Cor 
tape) of a given 
name may be onwline 
at atimee 


FILE IN USE The specified file Wait until the 
cannot be opened file is not in use. 
because it has already 
been opened by the 
maximum number of 
users allowed for the 
desired move i.e. 
input /out put e 
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EVENTS # 20-40 
INVALID REQUEST ON CLASS A OR B COMMUNICATE TO MCP 


These messages normally indicate program errors. Program in error should be DS’ed or DP’ed (see DS and 
DP intrinsics), if necessary. Then operator should attempt to run the program again. If the same error is encoun- 
tered, request technical assistance. 


Message format: 


mix number/program-name <EVENT#> CANNOT verb text parameter 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


20 CNULL) Itlegal verb. 


NOT FIE& Byte 1 of Priority A 


or B communicate sh- 
ould contain Data Seg- 
ment TabtLe Index of a 
File Information 
Block. Nata Segment 
Tabte does not contain 
Fite Information Block. 


2c FILE LOST The medium which None 
contained the file 
has been illegatty 
physicaity removed 
when it was still 
required (eeg.e half. 

close). 


23 ATTRIBUTE Each class A 
MISMATCH communicate is checked 

against the files 
attributes. Attribute 
includes such things 
as device» myuser 
access mode etc. This 
ae Se 
message indicates 
failure on this check | 
@ejge read on an output | 
disk files write cn a 

closed file etc. 


24 BA SEQUENCE Prior ity A error 
may be noted when 
OPENEC 170 with 
Sequentiat Access 
le REWRITE was not 
immediately pre-~ 
ceded by success™ 
ful REAC. 
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VENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


2- CVERWRITE was 
immediately orec= 
eded by OPEN or 
START communicat e. 
3-2 CVERWRITE or 
REWRITE was preced= 
ed by condit tonal 
READ which failed. 


BA) WORK Work Area Segment 

AREA specified within 
File Informat ton 
Block cannot be 
used» because it 
either indicates FIB 
segment or it is Read 
Only segment = yet 
communicate requests 
data transfer to 

that segment. 


ILLEGAL KEY Rey requested on 
Priority A comm- 
unicate for a disk 


was equal to zeroe 


**NONTRESTDENT COMM) AIT CATE HANDLER«* 


27 DEVICE NOT There 1s no device 
GON SYSTEM of tne requirec 
kind on the system. 


29 DUAL PACK The two parts cf a 
MISMATCH duat pack file have 

been found to be 
Inconsist ent . 


30 ALREADY OPEN Communicate requested 
3 an CPEN on already 
openec f i1€. 


31 ALRZADY Communicate requested 
CLOSED a CLCSE of already 
closed file. 


32 BA) ADVERB Adverb to OPEN was 
determined toa be 
illegal for any 
use of the follow- 
ing: 

1. MYUSE equal to “0* 
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EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


2e MYUSE incompat tiple 
with cevice (fcr exam 
ple» I/C for LP). 

3-2 Access moce Random 
for nonwcdisk device. 
4. Access mode rot 
equal to Sequenttiat 

or Random. 


33 BA B8LOCK CR kecorc anc/or Bicck 
RECORD SI Zé Size been determined 

to be incompat ible 
or tltegat for any 
of following reasons: 
1. Buffer or Record 
length equal tc zero 
for new cisk or tage 
files. 
2- Fecord lergth ex- 
ceeds physical Block 
S$ 1Z €. 
3- Buffer tength rot 
an tnteger multiple of 
Recorc length. 
4. FPB or CFH puffer 
Length not multiple of 
180 if ofc file is 
opened with soecified 
Buffer length cther 
than zero. 
5~- DFH Buffer Length 
not multiple of FPB 
Buffer length if cld 
file is opened with 
specified Buffer 
Length. 
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VENT MESSAGE 


4&0 


BAD FILE 
SEZE 


BAD NUMBER 
OF BUFFERS 


BAD DEVICE 


BAD FILE 
TYPE 


PROTECTION 
ERROR 


BAD FILE= 
NAME 


BAD KEYSIZE 


Number of buffers 


POSSIBLE CAUSES SUGGESTED ACTION 


Maximum fite size 
exceeds 1048560 or 
65535 if single area 
File. 


specified exceeds 
16. 


Device requested 
not supported by 
CMS. Device code 
is i1ilegalt.- 


1. An OPEN has been 
requested on “SYSMEM” 
file by unprivileged 
user program. 

2. Unprivileged useér 
program requested a 
CLOSE with Lock or 
Purge of file with 
SYSMEM VMFILE or 
Firmware File Type. 


Privileged user 
attempted to CLOSE 
with Lock or Purge 
a VMFILE or Firm- 
ware file while the 
file was stitt in 
usee 


OPEN or CLOSE has 
detected an iilegal 
special character 
Imbedded in fite- 
name. 


During OPEN of a new 
index files MCP has 
discovered in Fite 
Parameter Btock (CFPB) 
a key length of zero 
or one that exceeds 
28 bytes. 


EVENTS # 41-49 
Fatal Device Errors 


These messages indicate fatal hardware errors. The program encountering the error should be DS’ed or DP’ed 
(see DS and DP intrinsics) if necessary. Then the operator should attempt to run program again. If the same 
error is encountered the media (disks, tapes, etc) involved should not be used further until field engineering 
has been notified and media has been checked. 


Message format: 


mix number/program-name <EVENT#> file-name peripheral function message ERROR WHILE IN verb sta- 
tus 


The format of these messages is the same as the format for event numbers 1-9. 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


BA) LEVEL The implementation 

NUMBER number ina keyfile 
KFFR ts greater 
than tn is 
implement at ione 


DISK LOCKED Disk write errecr 
eccurrec at file 
close timee This 
could be either 
While writing last 
block» or uodcating 
Disk File Header 
or available tanile. 


43 EN) OF TAPE Unexpected end of 
tape encount ered. 


4& TAPE FORMAT Encing label or 
labelled tape is 
missing or invalid. 


PARI TY Harc priority error 
<STATUS > discovered on device. 


<STATUS> shows disk 
sector address for 
disk errorse 


46 TI ME OUT For tape devices no 
<STATUS > data was found for 
quite a cistance 
on tape Cexact tlergth 
depencs upon unit )s 
For disk» cylinder 
specif ied coulc not 
be founc.e 
<STATUS> shows disk 
cy Lincer address for 
disk errorse 
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SUGGESTED ACTION 


VENT MESSAGE POSSIBLE CAUSES 


ADDRESS Sector could not he 
<STATUS> found on disk C(cyl- 
inder was found). 
Either Software 
has indicated invatic 
sector or sector 
address or disk. is 
corrupt. 
<STATUS> shows disk 
Sector address for 
disk errors. 


4 8 REWIND Problems encount”" 
ered on rewinding 
a tape. 


Identifies I/0 error 
that is not PARITY» 
ADDRESS» or REWIND. 


DESCRIPTOR 
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EVENTS # 50-69 


Load Failures 


These messages indicate that the MCP failed to begin the processing of a particular program for some reason. 
Operator should correct the condition that caused the load failure and then try running the program again. 


Message format: 
[EVENT#] LOAD FAILURE message 


Examples: 


[53] LOAD FAILURE NO USER DISK 
[51] LOAD FAILURE PROGRAM NOT FOUND 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


DISK NOT Specified disk 15 Check for correct 
FOUND not online or disk; 
ready. RY disk if not ready 


PROGRAM NOQT Specified file Check input and reminput 
FOUND was not found | if necessary? 
on disk. Check for correct disk. 


System Cannot accept Allow one program to 
any additional prog- | come to End of Job 


FULL MIX 


rams of this Priority CE0N)~. Then begin 

Class at the moments | required program again? 
or program presently or DS unwanted prog 
running will not ram€(s)» if applicable. 
permit any other pro” Then begin required 


grams to enter the mix- program aaain.- 


NO USER There is not enough Remove with RM any 
DISK room on disk for unnecessary files? 
this program's 
Virtual Memory file. 
(VMFILE). 


INTERPRETER For B 90: 

NOT FOUND ———$____—_ 

COBOLINT or BILINTERP Supply» with COPY» the 

were not found on sys“ missing interpreters 

tem disk or have he from backup medium» 

come corrupted. Replaces» with COPY» 
the corrupted inter 
preters from backup 

medium» 
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INTERPRETER NOT For B 800: 
FOUND (cont'd). 


MCP may be corrupted; Replaces» with COPY, 


program operator is corrupted MCP from 

attempting to run backup medium; 

may be corrupted. Reptéece» with COPY» 
corrupted program 
with backup mediums 


55 USER COUNT Too many programs Wait until one or 


ERROR are trying to use more Prograns goes 
a file. Limit is to ECJ. Then try 
seven. againe 
56 CoDE FILE Data file name was Check input and re- 
ERROR mistaken for program enter. 


name» and an attempt 
was made to run the 
file instead of a 
programe 


INVALID LOAD Typing error. Check input and 
REQUEST CEXS too many char- rerenter. 


acters in program 
name). 


INSUFFICIENT There is not enough Request technical 
MEMORY room tn memory Cto assistance. 

hold this proram's 
Task Controt Block 
and Program Control 
Block). 


MCS ALREADY Onty one MCS may he 
PRESENT in the mix. 


60 DUPLICATE 2 or more disks with Rename one of the 
PACK the sam@ name are cisks with RLs check 
currently on-line» for correct disk. 


and this system does 
not permit this. 


61 NULL MIX Specified program Wait until alt 
REQUIRED may be run only programs go to EQJ 
if no other programs before running this 
are in the mix @e ge SQ programe 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ILLEGAL DATA An NDL task can be 
COMM LOAD loacec cntly as part 
REQUEST of the data conm 
loading sequencee Any 
other attempt to lcad 
an NOL task 1s fatled. 


DIS*< ERROR There nas been an 
irrecoverable disk 
error while attempting 


to loac a program 


UTILITY BUSY The operator has tried Wait until the 


to init tate a super= first function 
utility functicn end Se 
while another 1s in 


the mixe 


INSUFFICIENT The program rur 

REA) STORE structure cannot be 
constructec ir the 
amount of menory 
specified inthe reat 

store fielc of the 

EX commance 


DUAL ALPHABET The program recuires 

NOT SUPPORTED int eror et er arc MCP 
facilities tc support 
cual alorabet cr 
reverse escarpement 

and the current system 

does not. 
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EVENTS # 70-99 


System Errors 


These messages indicate system errors. The program encountering the error should be DS’ed or DP’ed (see 
DS and DP intrinsics) if necessary. Then the operator should attempt to run the program again. If the same 
error is encountered, technical assistance should be requested. 


Message format: 


mix number/program-name <EVENT#> SLICE# message 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


SEGMENT OUT Segment number ex 

OF RANGE ceeds number of 
Segments declared 
in the programe 


SEGMENT SIZE Offset and tength 

ERROR value exceeds 
declared size of 
Segment. 


STACK OVERFLOW Amount of Control Use MODIFY utitity to 
Stack requested dur increase control stack 
ing a run has exceed- size of programs and 
ed declared Stack rerun program. 

S1 zee. 


STACK Designated code 

UNDERFLOW has attempted to 
retrieve more 
information from 
Control Stack than 
1s present. 


INSUFFICIENT The program has 

REAL STORE attempted to exceed 
the memory size 
specified at toad 
time inthe real- 
store field. 


PROGRAM TCC The program has 

LARGE attempted to exceed 
the physical memory 
S 1Z €« 

BA) KEY The offset of key 

POSITION position is #ore 
than recorc sizes 
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EVENTS # 100-169 


Program Errors 


These messages indicate program errors. The program in error should be DP’ed (see DP intrinsics) if necessary. 
The source program, object program, dumpfile produced by DP, and any data files used by this program — 
should be saved. The operator should try to run the program again. If the same error is encountered, request 
technical assistance, and supply all relevant data saved to the technician. 


Message format: 

mix number/program-name <EVENT> SOURCE REFERENCING program segment # segment address pro- 
gram counter address message 
Examples: 


03/MYPROG <121> 0 SEGMENT 0 ADDRESS 
~-- 15 SUBSTRING ERROR 


04/PROGB <140> 2639 SEGMENT 18 ADDRESS 
-_ 436 CODE FILE ERROR 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


*ALL INTERPRETERS* 


COMMUNICATE MCP returned 28092 in 
ERROR Byte 0 of Fetch Mess 
age on a communicate. 


COMMUNICATE MCP returned an End 
EOF ERROR of File indication 

in Fetch message 

(320 20 003) and the 

user has not specif- 
ied any action if EOF 
occCurs-e 


102 COMMUNICATE MCP returned I/0 error 
1/0 ERROR indication tn Fetch 
message (220 30 002) 
and the user has not 
Specified any action 
to take if error occurs. 


SEGMENT NUMBER Interpreter detected 
ERROR an invalid code on 
data seqment number. 


WRITE ERROR 


Interpreter has detect” 
ed attempt to WRITE 
into a ReadOnly 
Segment or literat.- 
Code file has become 
corrupt or an error 
exists tn compiler 

or interpreter. 
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VENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


SEGMENT Interpreters in cate 
BOUNDARY culating an address» 
VIOLATION has discovered that 
the address of the 
data or code 1s out 
of range- Code file 
has become corrupt 
or an error exists 
in compiler or 
interpreter. 


** INTERPRETER for MPLII** 


110 INVALID OP Code file has become 
Corrupt or error exists 

in MPLITI compiler or 

Interpreter. 


DESCRIPTOR Program tried to store 
ACCESS CODE the fetch value to a 
non"character field» or 
to convert to a non- 
character field» or 
to store to a self~ 
relative descriptor » 
or an €rror in the 
SETNAME procedures or 
a decimal add e?rror- 


SEGMENT SIZE Segment tength is 
ERROR too tong or is Set 
while Segment is 
in core. 


ADDRESS ERROR SETNAME extent errors 
identifier has become 
out of scope 


MESSAGE Message reference 
REFERENCE field not divisible 
ERROR by 4» or illegal 
access to message 
reference space. 


STRING STORAGE Ittegat destinat- 
ERROR ion in store string 
instruction. 


REMAP ERROR Program tried to remap 


a bit descriptor. 


EVENT MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


SUBSTRING Attempt made to sub- 
ERROR string into non*char- 
acter area. 


INDEX ERROR 


Program tried to 
Index a self-relative 
descriotors» or to bit 
Index a Sselfrrelative 
descriptor. 


EXIT ERROR Local data returned 
from a function. 


124 CPA ERROR Frror in communicate 
parameter area: for 
examples message ref- 
erenced exnected»s or 
size of character 
field at least 3 
bytes expected. 


DIVIDE ERROR 


Divide by zero 
attempted. 


ZIP ERROR 


Error returned after 
ZIP (not used on 880) 


BIT DESCRIF- Bit fietd overlaps 
TOR ERROR more than one byte 
boundary. 


FPa 


ERROR Error in file para- 

meter DLock e@ncount” 
ered - subfield of a 
nonw7F.P.~B. segment 


requested. 


CONTROL STACK Control Stack over- 
ERROR flow or underflowe 


DATA STACK Ittegat descriptor 
ERROR encountered. 


DECLARATION Size of character 
MODE ERROR fietd greater than 
Loos 


DATA STRUCTURE Insufficient room for 
ERROR structure nesting or 
$1Ze of character 
field greater than 255» 
or insufficient roor 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


DATA STRUCTURE for array bound evat- 

ERROR (cont'd) uations or none-char- 
acter descriptor enc” 
ountered when charact~ 
er descriptor expect 
ed. 


“e*#.] NTERPRETER for COSOL and RPG«« 


INALID SOP Invalic S*0p-Ccde. Same as event 142 
CO9)c Code file is corrupt 
or error exists in 
CCBECL/RPG compiler 
or interpreter. 


| 141 INVALID CCPX °- Invalid COPX = greater Same as event 142 


GREATER THAN than size of COP table. 
SIZE OF CCP Code file corrupt cr 
TABLE error ian COBOL/RPG com 


pitler or interpreter. 


142 ALPIANU ME RIC Alphanumeric field Same as event 142 
FLE_-D TYPE ACT type rot 8bit uns 
Bw"BIT UNSIGNED signece Code file 
corrupt or errcr 
in COBOL/RPG ccm 
pttler or interpreter. 


[INVALID EDIT -Anvalid EDIT micro Rerun program from 
MICRO OPERATOR Cperator. Coce file gackup copye If stilt 


corrupt or error in in errors request 
COECL/RPG conpiler technical assistance. 
CCRECL/RPG cogpiler 

or interpret er. 


[ NLINE EDIT Inline EDIT MASK | Same as event 
MASK NOT not correctly ter- 
CORRECTLY mintedce Coce file 
TERME NATED corrupt or errcr in 
CCBECL/RPG conpiler 
or interpret er. 


EXAMI NE SOURCE EXAMINE source field Same as event 
FIELD ERRCR error.e Code file 

corrupt or error in 

COBCL/RPG compiler 

or int erpret er. 


EXAMI NE EXAMINE parameter Same as event 142 
PARAMETER FIELD fietda not 8~bit 
NOT 8*BIT unsigned character. 
UNSIGNED» ONE Code file corrupt or 
CHARACTER error in CQBOL/RPG 
compiler or inter- 
preter. 
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MESSAGE 


POSSIBLE CAUSES SUGGESTED ACTION 


147 EXAMI NE EXAMINE control byte same a event 1472. 
CONTROL BYTE error. Code file cerr- 
ERROR upt or error in COBOL/ 
RPG compiler cr irter- 
preter. 


148 COMPARE F Ck COMPARE for CLASS= 


Same as event i142 
CLASS “CLASS CLASS anc FIELD type | 
AND FIELD TYPE incompat ible. Code 
INCOMPATIBLE file corrupt cr error 


tn COEOL/RPG compiler 
or interpreter. 


149 SUBSCRI PTEL CR Coce file ccrrupt or 
I NOZXEO error in COBCL/ RPG 
SUBSCRIPT CR compiler or tnterp- 


INDEX reter. 


INDEXEDO/ 


The array has fore 


SUBSCRI PTED than three subscript s 
VARIABLE IS or incexes. 
INDEXED / 


SUBSCRIPTED 
BY MORE THAN 
3 VARIABLES 


FETCH 
COMMU NI CATE 

Ro SPONSE FIELD 
NOT OF LENGTH 
3 BYTES 


LNVALIO EXAMINE 
SPECIFICATION 


PreR- ORM STACK Indicat es too many The size of the perfora 
OVERFLOW PZ RFORMS without a Stack may be increased 
return for the dy the MODIFY cutilitys 
Perform Stack spec using the CIN TROL-STACK 
ified at ccmpile option to change the 
time Cif not spcec- PPB €see section 4). 
ified then the de- 
fault value was used). 
If tnais cid not 
resuit from a program 
ming errore the 
Perform Stack shcuid 
be incr easede 


1€1 NON“POSITIVE Subscripts must De 
OVERFLOW pos it iv e. 
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MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


EVENT 
| ARRAY BOUNC Subscript s out side 


VIOLATION upper bounc cf 
CCCURS Clause. 


164 TRANSLATION 
SOURCE ERRCR | 


INVALID SIGN 
CODE 


I /0 ERROR Invalid read/write 
to a file. 


An error has been 
encount ered in 
SCRY or MERGE. 


ZIP FALLURE Zip to another 
task has fatlec. 
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| EVENTS ## 170-199 
SORT Exception Events 


Any of these output messages may be displayed while SORT and SORTINTRINS are running. For reporting 
SORT errors: all SORT errors should be accompanied by either the Sort Spec or the COBOL program that 
requested SORTINTRINS, as well as the input file(s). Since SORTINTRINS is a machine-dependent program, 
the method of getting a dump may vary. To get a program dump on the B 80: rerun the program with “GT” 
on. This will cause SORTINTRINS to dump its run structure on the console printer. 


Message format: 


mix number/program-name <EVENT#> message 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


DUPLICATE Only for Keyfile I¢ duplicates are 
RECORO record creation. Another desired» specify 
number record in file has "QOUPLICATES™ in 
same key as this input. 
record. 


ILLEGAL INDEX Onty for keyfile 

KEY IN RECORD creatione Either 

record number the Key fietd is 
alt binary O or 
has one or more bytes 
with hex FF. This 
record wilt not be 
referenced from the 
keyfite- 


RECOROS LOST Probably indicates an see Introductory 
OR GAINED BY error in SORTINTRINS. paragranh concerning 
SORT*MERGE errors. 


number Normal message tells 

DUPLICATE the opertor the total 

RECORDS number of records 
that have duplicates. 
(See Event 170). 


number RECORDS Normal message tells 
CONTAINING operator totat number 
INVALID INDEX of records with 1n- 
KEYS valid index keyse (See 
Event 171 for further 
information). 


number Records with hex FF 
RECORDS in every byte position 
DELETED will be deteted by 
SORT. Informs operator 
how many records were 
deleted. 
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176 


7—24 


RECORDS 
MERGED 


MERGED 


SORT “MERGE 


NOT CREATED 


SORT “MERGE 
ABNORMAL 
EOJ 


SORT*“MERGE 
SOFTWARE 
FRROR 


number 
RECORDS 
REFERENCED 
BY KEYFILE™ 
TAGFILE 


NO INITIAT- 
ING MESSAGE 


number 
RECORDS: 
SORTED 


number FILES 


OUTPUT FILE 


POSSIBLE CAUSES 


Normal message for 


MERGE only. Tells op- 
erator total number 
of records merged 
from all files. 


Normal message for 
MERGE ontly- Tells 
total number of files 
mergede- Should be 
same as number of 
files requested in 
the Sort Specs. 


SORTINTRINS was OS*ted; 
may indicate corrupt 
SORT or SORTINTRINS 
programs. 


Early termination due 
to errors. 


Error in SORTINTRINS 


Onty for keyfite- 
tagfite creation. 
Telts number of ent- 
ries of keyfite/ 
tagfile. 


SORT INTRINSIC requir= 
es a property coded 
Initiating Message. 
This shoutd be prop” 
erty formatted by 

SORT or Sorts within 
programming languages 
such as COBOL. Probab- 
Ly indicates an att™ 
empt to execute SORT 
INTRINS directly. 


Normat message telis 
number of records 
sorted by the SORT 
utility. SORT succ- 


essful- 


SUGGESTED ACTION 


None. 


See introductory 
paragraph concerning 


SORT errors. 


See introductory 
paragraph concern 
ing SORT errors. 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


FILE ERROR The <number> means: see introductory 
<number> ON 1. ENF on output File paracreph concern 
SORT*MERGE 2- PARITY on Input ing SOFT errors. 
FILE file- Fite 
name Ze EDF on Sort Work- 

file 

4. Bad Disk Address 

Se SORT workfile Error 

6. Input File Error 

f+ Output File Error 

Except for 2» this 

probably indicates 

error tin SORTINTRINS. 


UNORDERED Files to be merged SCRT files for order. 
MERGE INPUT were found not to be Then retry. 
MERGE FILE increasinga/decreasing 
filename key value- Either the 

file is incorrect or 

the key position has 

been tncorrectly sne* 

cified. 


TOO MANY REC Machine=dependent See introductory 
ORDS FOR SORT Limitation- paragraph concernina 
MERGE SORT errors. 


DUPLICATE 


Was not specified Specify DUPLICATES 


RECORDS = © and duplicates exist. in tnput. 
KEYFILE NOT The keyfile will not 
RUILT be built and this 


message wilt be 
displayed. 


INIT MESSAGE Initiating message see introductory 
INV ALIO to the SORTINTRINS Daracraph concerning 
is not in proper | SORT errors. 
format. This could 
possibly be caused 
by a fault in the 
program that zipped 
the SORTINTRINS. 


SOR T*MERGE Informs the operator 
INITIATED which progtam used 
FROM mix the SORT intrinsic. 
number/prog- | 

ram“name 
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SECTION 8 
B 90 DEPENDENT SYSTEM SOFTWARE 


INTRODUCTION 


This section covers those items in the CMS software which are operationally different on the B 90 series from 
other CMS implementations. These differences are mainly a result of the different hardware features involved. 
The software covered includes: 


Powering the B 90 on and off. 

The B 90 CMS disk “bootstrap” feature. 
Stand-slone utilities, operating without MCP control. 
Loading the MCP. 

Particular features of the B 90 MCP. 

Taking memory (system) dumps 

Utilities released only for B 90 systems. 

B 90 system errors and symptoms. 


POWER ON 


Ensure no disks or cassettes are in the system (failure to do this may result in subsequent media corruption). 

Turn the system power on. It is then under the control of ROM which performs a mini-test of critical machine 
components to verify it is capable of starting. The successful completion of this test is verified by the PK lights 
lighting and then turning off sequentially, with PK1 and PK2 remaining lit. 

PK1 permits the loading of a cassette into the system. Some examples of cassettes to load would be (1) | 
AE 500 firmware to cause the B 90 to perform as an AE 500, or (2) ACSYS SL5 emulator firmware cassettes 
to cause the B 90 to process Series L cassette programs on disk. B 90 cassette loads are not used in CMS. 


PK2 permits the loading of information from a disk into the system. Some examples of disks to load would | 
be (1) ACSYS (SL5 emulator) firmware disks, or (2) CMS disks to cause the B 90 to load CMS firmware. 


Load the CMS disk in any available disk drive. 


A mini-disk is considered loaded immediately the drive. unit door is closed, and the blue indicator is lit (disk 
properly inserted and up to speed). For MCP control the disk must be write-enabled (red indicator lit). 


For cartridge disk, wait about 20 seconds for the cartridge to come up to speed (you hear a click as the heads 
access the disk). Ideally they should be run initially for a few minutes before use to achieve correct running © 
temperature. For MCP control the disk must be write-enabled. 

For fixed disk, wait until the READY’ half of the “BUSY/READY” button is on. 


Depress PK2 to enter CMS Bootstrap Mode (see pele) The various states, including Initial State and Boot- 
strap Mode, are shown in figure 8—1. 


Possible errors in power-on sequence are given below, System Load Errors. 
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POWER ON, OR 
DEPRESS LOAD ENABLE BUTTON 


INITIAL STATE | 


PK1 PK2 


ACTIVATE 
CASSETTE 
BOOTSTRAP 


ACTIVATE DISK 


BOOTSTRAP 
IN ROM 


IN ROM 
(NOT USED 
BY CMS) 


ACSYS CMS 
DISK . DISK 
SEE PRESENT PRESENT 


ACSYS 
DOCUMENTATION 


PO SYSTEM 
DISK CMS BOOTSTRAP MODE 


PK3 PK4 PK5 PK6 

OR 

FATAL 

ERRORS 

MCP 
WARMSTART MEMORY 5G 
MEMORY eee pei 

14 TO STAND-ALONE ene 
DUMP DISK 


TO UTILITIES 
CASSETTE (SAU) 


Figure 8—1. B 90 Coldstart and Warmstart 


CMS BOOTSTRAP MODE 


From the Initial State, depression of PK2 initiates a ROM load routine which searches through all present 
disks until it finds the bootstrap code. 


Successful load of CMS bootstrap: PK3 through PK6 will be lit, to provide the following facilities: 
PK3 - warmstart MCPX | 
PK4 — dump contents of memory to cassette. 
PKS — dump contents of memory to disk. 
PK6 - enter stand-alone utilities (SAU). 


Note: 


The search for a bootstrap code proceeds as follows: 
bottom drive of highest-channel disk unit 
top drive of highest-channel disk unit 


bottom drive of lowest-channel disk unit 
top drive of lowest-channel disk unit 
and stops at the first bootstrap, whether a CMS bootstrap or ACSYS bootstrap. For example, if there is one 
cabinet with two cartridges, DKA and DKB, then DKB will be searched first. If there is more than one disk 
cabinet, you can find the channel address from the field engineer. 


A Note on Forcing System Initialization 


When the system hangs (that is, it is not performing any functions or responding to any input from an 
operator, but has not returned to the initial state), it is necessary to force the system to initialize. 


This is done by depressing the Load Enable button in the main cabinet. Never switch the cabinet off, or un- 
load disks or cassettes in use, as this can cause media corfuption of various kinds. 


If the correct procedure is followed, then although disk or cassette files may be only partially created or up- 
dated, the system when recovered should be still able to access the media. 
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STAND ALONE UTILITIES 


_ The SAU process has the necessary functions to prepare a disk for use on the B 90. This process is used 
to initially transfer system software (MCP, interpreters, compilers and utilities) to a new disk at a new installa- 
tion, or to install a new level of MCP at an existing installation. It is also used to condition new disks (IN 
Initialize) or recondition (RF reformat) existing disks for copying on the B 90. 


The SAU functions are brought into memory from disk and operate independent of the MCP. 


Loading Stand-Alone Utilities 


The system must be in the CMS Bootstrap state. If the system is in the initial state, depress PK2 to get to 
CMS Bootstrap State (PKs 3 through 6 lit). 


Depress PK6. System will search disk (from which bootstrap was loaded) for a file called SAU. 


If this disk does not contain SAU, then any disks (containing bootstrap files) located on a lower channel will 
also be searched. For each disk you must depress PK6 until search is complete. 


_ (For failures in search see below System Load Errors). 


Verify by a printed message that the SAU has been loaded into memory from disk. 
STAND-ALONE UTILITY 
VERSION n.nn.nn 
REQUEST “HELP” FOR FUNCTION SUMMARY 
FUNCTION 


Functions Available 
initialize a disk: IN 
reformat a disk to the initial state: RF disk-name 
load files to disk from cassette: LD disk-name FROM cassette-name 
copy files from disk to disk: COPY disk-name/file-name TO disk-name/file-name 
remove disk files: RM disk-name/file-name 
list the disk files and their sizes: LS disk-name/file-name 
relabel a disk: RL disk-name 
list status of drives: OL 
warmstart the MCP: WS 
initialize a disk for MTR use: FE (field engineers’ use) 
terminate stand-alone utility execution: PO 
change file-name on disk: CH disk-name/file-name TO disk-name/file-name 
clean BSM disk drive read/write heads: CLEAN 
compare files on disks: COMPARE disk-name/file-name WITH disk-name/file-name 
print disk directories: PDX 
duplicate BSMII: DISCOPY drive TO drive 


When the Stand-Alone Utilities are running, only the ON light is lit. Each of the utilities is initiated by a 
command on the Alpha Keyboard. Only one utility may run at a time and keyboard input is valid only when 
no utility is running. Keyboard input entered while a utility is running will be lost except for the first four char- 
acters. The reset key. will clear all keyboard input since the last OCK key, and any OCK key will terminate 
keyboard input. . | | 
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Common SAU Output Messages 


MESSAGE 


FUNCTION ABORTED 


Dxy DEVICE cRROR 
DEVICE INOPERABLE 


Dxy DEVICE ERROR 
OFF CYLINDER 


JDxy DEVICE ERROR 
WRITE INHIBITED 


IDxy DEVICE ERROR 
SEEK TIMEOUT 


Dxy DEVICE ERROR 


Note: | 
x identifies type of disk 


POSSIBLE CAUSES 


Hardware errore 


Specifiec drive nas 
accidentaliy rade 
Not Reacys or crive 
unit malfunct ior. 


Crive unit malfunc= 
tione 


Cisk in specified 
crive has its write 
lockout incicator 
sete 


Drive untt malfunct= 
ion 


Crive untt malfunct= 
tion 


Prompt to request Op 


er ator to erter next 
cesirecd funct icne 


SUGGESTED AC TION 


If this message 15 

preceded by another 
message then follow 
that messager else 

notify field eng-. 

ineere 


Ready drives or 
notify field engineer. 


Nofity field engineer. 


Ensure that the Write 
Lockout Hole (BSMND) 
is covered» or for 
cartridge = the Write 
tockout Piug is flush 
with surface of 
cartridge. 


Notify field engineer. 


Notify field engineer. 


Enter next functions 
or "HELP*™ to display 
list of functions. 


(M = BSMD, F = FIXED, K = CARTRIDGE, 5 = BSMDIT) 


y identifies unit 
(A, B, C, etc.) 


Disk I/O Errors during SAU 


These errors are identified by the messages: 
O/P ERROR, I/P ERROR, <unit> DIRECTORY I/O 
ERROR, <unit> DEVICE ERROR 


which may be encountered while running the Stand Alone Utilities. 


Disk I/O errors indicate a failure to read from (I/P error) or write (O/P error) disk. Such problems should 
not be allowed to persist on a disk which is to be used to store important information, especially where the 
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disk is to be used as a systems disk. Therefore an explanation or fix is required before the drive and disk can 
be considered acceptable for live use. Even if the Stand Alone Utility continues to run satisfactorily, there may 
be some form of disk corruption. After any of these errors, the media involved should be checked for any cor- 
ruption which might cause future system problems (for example, the CHECK.DISK, KA, or DA utilities under 
MCP control). | 


A Note On Dual Pack Files 


A ‘dual pack file’ is a file which resides on two separate disks or logically identified disks (for example, 
DFA and DFB). 


A dual pack file consists of: 
A disk file header on each of the two disks. 
At least one and at most sixteen file areas, each of which may be allocated on either disk. 


_Both parts have the same file name. 
Under MCP control, the file may be opened only if both parts are present. 
Each file header contains a reference (the pack-id) to the other disk. 


Therefore if for any reason one part of the dual pack file is lost, or if the pack-id of one of the disk volumes 
is changed, the file will be inaccessible under MCP control. | 


Therefore caution must be exercised when using SAU to initialize, reformat, or relabel any disk containing 
part of a dual pack file. Dual pack files may be located with the LS function. 


In addition to the file-name and area occupied, the LS function will give, for each dual pack file, and overflow 
pack-id and the total overflow area. 


If one part of a dual pack file is lost for any reason, the SAU RM function may be used to remove the 
remaining part. 


The terms ‘‘master file” and ‘‘overflow file” are sometimes used to distinguish the two parts of a dual pack 
file, however it should be borne in mind that either part of the file may be regarded as the master file. In 
this section the term ‘‘master”’ file is used to indicate the part of the file mentioned in a COPY or RM com- 
mand. 


CH (Change disk file name) 


This function allows the operator to change the name of disk files. 


Format: 


fileename 
CH disk-name/ or 
group-name 


Examples: 


file-name 


TO disk-name/ = or 


groupname 


To change a file ARO30 on a disk ARDISK to PRO30X: 
CH ARDISK/AR030 TO ARDISK/PR030X 


To change a group of files starting with GL on a disk GLDISK to a group starting with AP: 
CH GLDISK/GL= TO GLDISK/AP= 


Output Messages: 


filename CHANGED 
TO file-name 


file-name NOT CHANGED 
ILLEGAL FILE-“ID 


filesmname NOT CHANGED 
O/P LENGTH OVERFLOW 


file~name NOT CHANGED 
U/P LENGTH UNDERFLOW 


lpUPLICATE FILE 
filename 


filename NOT FOUND =~ 

—|ifilewtname NOT CHANGED 
IINCOMPLETE DUAL PACK 
FILE | 
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POSSIBLE CAUSE 


function successful 


filename or group™ 
name contains an 
iliegat character 


The resulting file- 
name is Conger than 
i2 characters 
Cpossitbly during a 
group change) 


When changing a group 
name to a smaller 
group name» the 
resulting file has 

no characters (for 
examples changing 

F= to = when a file 
called “F" is present) 


An attempt was made 
to change a file to 
the name of an 


alreadytexisting 
file 


The file is a dual>- 


pack fite and the 


overflow pack 15 
mounted but the tite 
iS not present 


SUGGcSTiD ACTICN 


Check input and 
reenter 


Check the group™name 
and rewinput 


Correct the yroup- 
name and rerinput 
if necessary, or. 
enter another CH 
tor the file not 
changed 


Correct the input 


and rewmenter 


investigate why the 
other part of the file 
is missing 
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PACK disk~name Not 
ON LINE ~ filename 
NOT CHANGED - 
INCOMPLETE DUAL PACK 
PILE 


filename NOT CHANGED 


DUPLICATE FILE ON 
OVERFLUW PACK 


8-8 


POSSIBLE CAUSES 


The file is a dual 
pack file but the 
overflow pack is not 
present 


An attempt was made 
to change the nane of 
a dualspack file to 
the name of a file 
already present on 
the overflow pack 


SUGGESTED ACTION 


Make the overftow 
pack present and 
reminout 


Correct the tnput 
and reenter 


CLEAN (Clean BSM Drive Read/Write Heads) 


The read/write heads of the one megabyte mini drive are cleaned by this function. This cannot be used on 
any other type of drive. Each head is cleaned in turn by the Burroughs head cleaning diskette. 


The procedure the system follows to clean one head is as follows: 

Load head onto cleaning surface. | 

Sequentially access the disk from the outermost track to the innermost. 

Sweep heads foul the outer to the inner-track and back, ten times. 

Unload head. 

The current postion of the head on the disk is visually displayed by illuminated PK lights. 


Example: 
CLEAN 
Output Messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


Prompt requesting Piace cleaning disk 


operator to insert into proper drive. 
cleaning disk into Make certain disk is 
proper drive. write inhibited (write 


inhtbit hole 1s covered 
and is positioned at top 
corner of disk). 


{LOAD WRITE INHIBITED Cleaning disk was Enter "OK" plus OCK1 

CLEANING DISK AND inserted into to start cleaning 

TRANSMIT "OK" TO drive. procedure; or press 

CONTINUE OCK1 to terminate the 
function. 


HEAD 1 CLEANED. Head 1 has been Turn disk upside down 
FLIP WRITE INHIBITED cleaned. (write inhibit hole 
JCLEANING OISK ANDO to bottom) so that 
TRANSMIT "OK" TO cleaning surface faces 
CONTINUE. other sides then enter 
"OK" and press OCK1 to 
tegin cleaning funct™ 
TONS « 


HEAD 0 CLEANED Both heads have Remove cleaning disk 
END CLEAN been cleaned. Func- and store. 
tion endse 


Any attempt to clean 0 before head 1 will result in the “LOAD/FLIPDISK” message being prompted. 


WARNING . . 
Any attempt to use a write-enabled disk or any disk other than the cleaning disk 
during execution of this function will result in serious damage to the disk drive. 
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COMPARE (Compare two disk files} 


This function allows the operator to compare files present on disk. 


Format: 


| filename 
COMPARE — disk-neme/ or 
groupname 


Examples: 


| filename 
WITH _ disk-name/ or 


groupname 


To compare a file PR200 on disk PRDISK with another file PR200 on disk USER: 
COMPARE PRDISK/PR200 WITH USER/PR200 


To compare a group of files starting with IN on the disk INDISK with group of files starting with XY on 


the disk XYZ: 


‘COMPARE INDISK/IN= WITH XYZ/XY= 


Before the files are compared a check is made that the file sizes and number of areas are consistent. If any 
conflicts are found here, the function will be terminated. 


Output Messages: 


MESSAGE 


file-name NOT FOUND 


FILE SIZE CONFLICTS - 
END COMPARE 


}CONF ICT IONS IN NUMBER 
OF AREAS = END 
COMPARE 


disk-nane/file-name 
COMPAREC WITH 

Idisk-name/file-name 
NO CONFLICTS FOUND 


|diskmname/file-name 
COMPARED WITH 
disk=name/fiie - 
ICONFLICTS FOUND 


PACK diskmname NOT 
ON LINE =~ filename 
NOT COMPARED - 
INCOMPLETE DUAL 
PACK FILE 
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POSSIBLE CAUSE 


Sel fm-explanatory 


One file contains 
more records than the 
other 


The number of areas 
assigned to the two 
files are different 


successful fite 
comparison 


The compare was 
unsuccessful 


Comparison of dual 
pack file was required 
and the oveftow pack 
Was not on Line 


SUGGZSTZD ACTION 


Check input 


Check SPO and error 
logs for any errors 
during copying of 


either files re~copy 
file€Cs) from backup 
disks and re-run the 
COMPARE function 


Make the overftow 
pack present and 

reminput COMPARE 

function 


PCSS IBLE CAUSES SUGGESTED ACTION 


filename NOT FOUND Comoarison of dual 

filename NOT COMPARED pack file was required 

INCOMPLETE DUAL and the overflow pack 

PACK FILE was present but did not 
contain the required 
file 


Investigate why the 
file was not present 
on the overflow pack 


END COMPARE end-of-job of this 
Se AeU function 
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COPY (Copy files disk to disk) 


This function allows the operator to copy files from one disk to another. Overflow files will not be copied. 


Format: 
| filename filename 
COPY § disk-name/ or TO  disk-name/ or 
groupname group-name 
Examples: 


To copy a single file: 
COPY PR1/PR200 TO PRBU/PR200 


To-copy a group of files: 
COPY PR1/PR= TO PRBU/PR= 


To copy all files on one disk to another: 
COPY PR1/= TO PRBU/= 


To copy a file and change its name: 
COPY PR1/PR200 TO PRBU/PR200B 


Output Messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


= System detected a file Normatty» remove 
name on disk identical the existing file 
to that which the op- with RM> reattempt 


DUPLICATE FILE NAME 


erator is attempting the COFY. Check input 
to copy- No two fites for Correct spec 
with the Same name ification of file 

may reside on a diske namese 


Therefore specified 
file was not copted. 


| filecname TOG LARGE Insufficient avail- Use a different disk» 
able space on dest or first remove some 
ination disk for the files using the RM 
specified file to function. 


be copied. 


When this disk was The COPY function ends 
initialized» the disk automatically. IF 


NAME LIST FULL 


directory was const- possible» remove with 
ructed to contain a RM any unwanted file(s) 
fixed number of file | to make room in the disk 
names. The directory directory. Then reo 
has now reached its attemot to COPY the file 


capacity. which encountered the 
| errors, | 


| (cont'd) 


8—12 


POSS IBLE CAUSES SUGGESTED ACTION 


Replace the disk with a 
disk that has sufficient 
room in the disk direc= 


tory. 
Dxy DIRECTORY ~ A reac or write error i.Chance the position of 
I/O ERROR | Was encounterec while the disks and retry. 


the system was attemrt- 2.For a group copys som? 
ing to access the dir= files may be recovered 
ectory of the specifim using single file copy. 
ed diske The directory If these attempts fail 
structure of the input then type of error 


(source) cisk fay de shoctld 3e analyzed with 

corrupt ed. DA utility and disk 
re-initiatized before 
rev use. 


/? DISK IS NOT Cest inat ion disk For cartridges: as 
WRITE PERMIT. Cdisk to which | certain that write 
System 1s copying lockcut plug 1s 
1s wr it-e inh ib it ed. flush with outer 
surface of cartridge> 
For 8S4D: ascertain 
that the write lockout 
hole is covered; 
Retry the Cj)? Y. 


file-name NOT F OUNC Specifiec filename Check input = recrenter 
is not on Ccisk. if necessary, | 
Check for correct 
disk. 
PACK disk=naae NOT Specified cisk 15 Check input ™ rementer 
ON LINE not onttine to the If necessary, 3 


comput er. Check for correct 
disk» 


INVALID REQUEST Typing error. Check input and re-~ 
| enter. 


None 


Copy successful (E0J)5 if copy successful» 


Specified grour name Check tnput = reenter 
to be copied is nat df necessary, 


on disk. Check for correct disk. 


file-narmne COPIED CCPY successful 
CANNOT ALLOCATE | Insufficient avail- Using KA utility» 
AREAS FOR = file> able space on cisk analyze disk avail- 
nage to which operator is aple space. 
attempt ing tc copy 

this file. 
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MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


fila-name NOT The resulting file- Correct the group 
CHANGED ~- O/P | name is longer than name and retinpute 
(LENGTH OVERFLOW 12 characters. 


filename NOT The resuit ing Correct the group 
CHANGED = O/P filemrame has no name and restinput 
JLENGTH UNDERFL OW charact erse 1f necessarye 


- file- Error encourt ered Allow COPY to continue 
while system was att- copying any remaining 
emptirg to write files. Then reattempt 
specifiec file to copying the file in 
disk. which the )/? error 

| occurred. 


- file- System encounrt ered Allow COPY to continue. 
errors inthe file — Then use backup copy 
from whitcn it was of the specified file 
reading. and revattempt the 

COP Ys switch tte disks 
to the opposite drivese 


filename NOT COPIED: Specifiec fiierrate Check input and rewenter 
ILLEGAL FILE“ID contains an illegal if necessary. 

character (that 15S» 

/ 2)» therefore file 

witt not be copied. 

Legal characters are 

O~9» AmZe « (dct )»p 

- (dash ). 


file-name COPIED: Diskwtocmdisk ccpy 1s 
ILLEGAL FILEwID being mace and this 
warning 318 given that 
the new file is copied 
but with an irvalid 
f ile-name. 


Dual Pack Files 


The copy function cannot create a dual pack file, however a complete dual pack file may be copied to a single 
disk. 


The master file will be copied first. COPY will then look for a matching overflow file on the overflow pack. 
If a matching overflow file is found it will be copied and the function will terminate with the message: 


filename COPIED FROM disk-name-1 AND disk-name-2 


If the overflow pack is not on line or the overflow file is not found or an overflow file is found which does 
not match the master file, the function will print the following message, and wait for operator input: 


disk-name-file-name IS AN INCOMPLETE DUAL PACK FILE 
A MATCHING OVERFLOW FILE ON disk-name-2 IS NOT PRESENT. 
PLEASE TAKE ONE OF THE FOLLOWING ACTIONS: 
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A. SUPPLY THE CORRECT OVERFLOW PACK AND 
TYPE “A” TO TRY AGAIN. | 
B. TYPE “B” TO SKIP THIS FILE. 


At this stage the master file pack may be removed if necessary. 


The operator should either power on the correct overflow pack and type ‘“‘A” followed by OCK1 or type 
“B” followed by OCK1. 


If the “A” option is selected the function will repeat its search for the overflow file as above and either ter- 
minate normally or repeat the prompt to the operator. 


If option “B” is selected the output file will be purged and the function will terminate with the message: 
file-name NOT COPIED, PART OF A DUAL PACK FILE 
WARNING 
If a level of SAU earlier than 3.00 is used to copy a dual pack file or a family con- 


taining a dual pack file, the output disk is liable to be seriously corrupted and to 
require re-initializing. 
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DISCOPY (Duplicate a BSMIl Disk) 


This function allows the operator to copy the contents of a Burroughs Super Minidisk II (BSMDII) to another 


BSMDII. 
Format: 


DISCOPY DS5X TO D5X 


where X = A, B, etc. 


All information is copied from one BSMII to another, that is, disk label, bootstrap, directories and data. Thus 
a complete disk can be duplicated for backup purposes without initialization. The automatic relocation of bad 
sectors allows the duplicated directories to remain valid since all information on the duplicated disk will have 


the same logical, if not physical, address as that on the master disk. 


Output Messages: 


POSSIBLE CAUSE 


SUGGESTED ACTION 


“ND DISCOPY end of function 
Either of the disks 
specified is not a 
B8SMII disk 


NON #BSMIT DISK 
SPECIFIED 


PACK This 15S a prompt for 
the operator to yive 
the sevenwcharacter 
disk™name of the 
Input disk 


drive-mnemonic PURGED An input error has 
occurred during the 
copye The output 
disk 1s purged by 
overwriting track 
zero with “null” 
characters. 


-UNCTION ABORTED - An I/O error has 
drive"mnemonic 


NUT PURGED 


and the copy 15s 
stonped. 


drivetmnemonic COPIED function successful 


TCO drivesmnemonic. 


occurred on the outout 
drive during the copy» 


none 


This function can only 
be performed on BSMII 
disks: use COPY for 


other kinds of disk» 
including 8BSM (1¥8) 
disk 


Enter up to seven 
characters 


Investigate cause of 
error on the input 
disk» then rewtrun 

the DISCOPY function: 
the purged output 
disk may be rermused. 


Use the LS function 
to determine which 
files are successfully 
cooied to the ouput 
disk: these may ce 
recovered. Otherwise 
re-run the DISCOPY 
function using a 
different output disk. 


FE (Initialize MTR Disk) | 


A virgin or a formatted disk is initialized to CMS format with suitable sectors reserved for MTR test routines. 
(These sectors will be denoted as BAD sectors on a KA map of the disk). The surface is checked by writing 
and reading test patterns to each sector. Bad sectors and the MTR tracks are made unavailable. A disk label 
is written and the file directory is created with a single, SYSMEM, entry. Sectors 1 through 31 are loaded from 
a file called “CMSBOOTxxxxx” which can be contained by any on-line disk or by any cassette labelled | 
“SYSB90” which has “CMSBOOTxxxxx”’ as its first file. 


The “xxxxx”’ characters are ignored by the utility; only the seven leading characters are compared’ when the 
on-line disks are searched (that is, the file specifications searched for is equivalent to CMSBOOT=). 


In the case of fixed disk, the CMS bootstrap will be loaded from CMSBOOTxxxxx. All other disks initialized | 
by FE will extract the MTR bootstrap. a 


The MTR tracks will not be included in the number of bad sectors, but if the disk is reformatted (see RF), 
the total number of sectors removed from the available table will be referred to as BAD. | 


Example: 
FE 


Output Messages: 


ESSAGE PCSSIBLE CAUSES _ SUGGESTED ACTION 


Prompt allowing entry Enter Drive 

of drive where disk Cex: DKAe DMB» etc) 
to be initialized is 

locat ed. 


Prompt atltlcwing entry Enter date 
of init ialization (format MM/DD/YY) 
dat eo 


Prompt allowing Enter maximum number 
entry of maximum of files this disk wilt 
number of files contain (less than 

for this disk. | 2805). 


Prompt atlowing Enter serial number 
entry of disk serial (6 numerals). 
number. 


Prompt altowirg Enter disk=-name 

entry of disk rame. (up to 7 tlegal char act= 
ers) 
Legal characters includ 
O79» A=Ze -« (dot)» 
- (dashde 


Prompt allowing ertry Enter valid inform- 


of usermcef inec in= ation Cup to 14 
format ion.e characters)e 


2015228 — 8—17 


POSSIBLE CAUSES 


SUGGESTED ACTION 


RESTRICTED 


BOJTSTRAP VERSION 
NMenNhenn USE END 
FE 


NO OF BAD 
SECTORS number 


TRACK O0 BAD 
SYS390 NOT PRESENT 
1DAD CMS BOOTSTRAP 


AND HIT OCK1 TO 
CON TINUE 


BAD MTR TRACK 


CYL xxx BAD 
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Prompt requiring res- 
ponse of "N*® at this 
time. 


FE (£03) 


Disk was successfully 
Iinttialized. If any 
bac sectors were dete 
ctec the number is 

display ece 


Sector(s) wn Track 

0 are bac anc carnct 
re usece FE will end, 
as a CMS disk must 
contain reserved 
infor mat ton in Track 
GO Cex: warmstart 

boot strap). 


System fatiec to find 
a bootstrap file from 
either disk or cass* 
ette 


Any MIR track contains 
a bad sector. 


In cases where certain 
cylinders are used for 
MTR purooses but not 
removed frcm the 
available table dis- 
covery of a bac sec 
tor wilt terminate the 
funct 10ne | 


Enter "VV". 


None. 


None. 


Select another disk 
to be initialized 
with FE. 


Load another drive with 
a disk containing 
C4SB839T or load a 
cassette with name 
SYS890 containing 


C4 SBj IT. 

Then press JCKXle System 
hilt re-attempt search 
for C45S890T. 


Select another disk 
to be initialized 
ay FE. 


IN (Initialize a Disk) 


The MCP (Master Control Program) requires that any disk to be used on the system have a valid CMS disk 


label, disk directory, and available area table. In addition, each sector of the disk must be initialized with its 
address. | | 


The IN function performs this disk initialization. It will check the recording surface of each disk by writing 
and reading test patterns to each sector of the disk. Any ‘bad sectors” (unusable or unreadable) will be re- 


moved from the disk’s available area table, and the number of bad sectors will be displayed to allow badly worn 
disks to be discarded. | 


The function will also write a disk label containing information supplied by the Operator to the appropriate 
prompts, below, and create a disk directory of the appropriate size required for the number of files specified, 
plus a single, SYSMEM, entry. Sectors 1 through 31 of the disk are loaded from a file “CMSBOOTxxxxx” — 
which may be located on any on-line disk or on any cassette labelled “SYSB90” which has “CMSBOOTxxxxx” 
as its first file. Before loading can take place, the correct identification string must be found in sector one of 
this file, namely, BSODISKINITVAOF. The disks are searched in descending order, cartridge disks first, then 
a further scan of Burroughs Super Mini Disks. 


Since all fixed disks must be suitable for MTR purposes, the functions IN and FE are identical in this 
particular case. The relevent MTR tracks will be checked and/or removed and the CMS bootstrap is written. 


Example: 


IN 


Output Messages: 


PCSSIBLE CAUSES SUGGESTED ACTION 


i0 OF BAD SECTORS Disk was successfully None. 
ua ber initialized. If any 

bad sectors were det- 

ected the nuarber 

found is disptayed. 


BOJTSTRAP VERSION 
Mennenn USE) END 


If successful (CEOJS) 


SYSB 90 NOT PRESENT System failec toa Load another drive 
ROAD CMS BOOTSTRAP find bootstrap file with a disk containing 
ILE AND HIT OCKI on disk or cassett ee C4¥SB)9T or load ato 

TO CONTINUE. cassete with name 

| SYSB90 containing 
C¥SBIODT as its first 
file. Then depress 
cassette» then press 
OCKL. System will re- 
attempt search for 

CM SBI0T- 
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MESSAGE 


TRACK O BAD 


DRIVE 


DATE 


SERTAL 


PAC « 


OWNER 


RESTRIC TED 
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PCSSTIBLE CAUSES 


sector(s) in Track 0 
are bad anc cannot 

be usece IN wilt ter- 
minate»s», as a CMS disk 
must contain reserved 
inf or mation in track 
QO Cex: warmstart 

scoot strap ).e 


Prompt altlowing 
entry of drive in 
which cisk tc be 
init ializec is 
locat €Ce 


Prompt allowirg 
entry of init iatiz- 
at ion cat e. 


Frompt attlowing ertry 
of maxiwum rumber of 
files for this disk. 


Prompt allowing entry 
of disk serial 
number 


Prompt allowing entry 


of cisk names 


Frompt aidlcwirg 
entry of userwcefined 
information. | 


Prompt requiring 
response of “N" at 
this t ime. 


SUGGESTED ACTION 


Select another disk 
to be initialized. 


Enter drive Cex: 
DKBe OKA» etc.) 


Enter date (format 
MM/DD/YY for months 
day» years ee ge C1L/23/75) 


Enter number of files 
disk will contain 
(less than 2805). 


Enter serial number 
(6 numerals). 


Enter disk=name 


Cup to 7 characters). 


rnter any valid 
information 
Cup to 14 charécters). 


Enter "NV", 


LD (Load Disk) 


This function allows the operator to load all files from a dump tape to a disk. A dump tape is one produced | 
by the DUMP or UNLOAD functions of the utility “LD” (which run under MCP control). Each sector of data 
written to disk is verified. The SAU LD function cannot create a dual pack file. 


Format: 

LD disk-name FROM library-tape-name 
Example: 

LD ARDISK2 FROM ARTAPE 


Output Messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 
file-name LOADED Disotayed for each 
file toaded and 
verified. 


LOAD REEL number Dump tape is a reel Supply next reel. 
from a multivreet 
dump and the next 
reel tS required. 


END LD LD (CEOJ) None. 


NOT DUMP TAPE Specified tape 1s Supply correctly 
not a correctly formatted dump 
formatted dump tape. taper retinitiate 
Function ENDS. LD. 


| multi-file-name Specified tape is Instatl and ready 

NOT PRESENT. LOAD not instatted and taper re"initiate 

CASSETTE AND HIT ready> Function ends. LD> or press OCK1!i 

OCK1 OR HIT ANY KEY 7 to retry search for 

THEN OCK1 TO TER@= multivcreel name 

MINATE. tapes or press any 
key plus OCK1 to ter- 
minate LD. 


UNRECOVERABLE Error was encounter- Ready cassette drive 
CASSETTE ERROR ed while system was unity re~initiate 
attempting to read LD. 
cassette. Normally 
caused by accidentally 
opening cassette drive 
unit. Functton ends. 


2015228 a 8-9] 


PACK disk"name 
NOT FOUND 


O/P DISK NOT 
WRITE PERMIT 


DUPLICATE FILE 
NAME - filename 


CANNOT ALLOCATE 
AREAS FOR = 
file-name. 


O/P ERROR = 
filename 


AREA SIZES Tog 
SMALL FOR - 
file-name. 


NAME LIST FULL 
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PCOSSTP@LE CAUSES 


Specified disk is not 
ready> specified disk 
is not online to con- 
puter. 


Disk to which files 
are to be loaded 
is write protected. 


Function ends. 


File of specified 

name already exists 

on destination disk. 

A disk may not contain 


2 fites with the same 


namee LD continues 
loading other files, 
ignoring any duptic= 
ates. : 


No appropriately 
sized available 
area on the dest- 
ination disk for 
specified file. 


Disk. write error 
encountered white 
system was toading 


soecified file. 


Insufficient avatl- 
able area on disk 
for specified 
muiticrarea file. 


No space remaining 
in disk directory 
for another fite 
Nnamee Function ends. 


SUGGESTED ACTION 


Ready the disks 
Check for correct 
disk. 


Ensure that write 
lockout hole is 
covered (for BSMD)>» 
for cartridge * ensure 
write tockout plug is 
flush with surface of 
oisk cartridges 
re"initiate LOD. 


Remove Cwith RM) the 
€xisting file from 
disk» then rectinitiate 
LD. 


If specified file 
is desired» replace 
this disk with a 
disk having more 
available area. Then 
re"inittate LD. 


Place disk in opposite 
drive and recinitiate 
Lp. 


If specified file is 
cesired» replace this 
Gisk with a disk having 
more available area. 
Then retinitiate 

LD. 


Use another disk» or 
remove unwanted files 
with the RM function. 


LS (List File Sizes) 


This function allows the operator to print name and sizes in sectors of files on a specified disk. For dual pack 
files, both portions of the files and their sizes are printed. 


Format: 
LS diskname/ oF | 
groupname 

Example: 


To list file sizes of all the files on the disk ARDISK2 
LS ARDISK2/= 


Output Messages: 


|] MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


PACK disk-name NOT Specified disk is Check input ™ reenter 
ON LINE | not on line to the 1f necessary? 
| computer. Check for correct disk. 


LS successful (CEOJ) None. 
Dxy DIRECTORY I/0 A read or write error 
ERROR. was encountered while 
the system was atte- 
mpting to access the 
directory of the 
specified disk. 
The directory struc@ 
ture of the disk may 
be corrupted. 
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OL (Print Status of Drives) 


This function allows the operator to print the status of all cassette and disk drives. 
Example: 
OL 


Output Messages: 


MESSAGE PCSS TELE CAUSES SUGGESTED ACTION 


END OL | OL successful CEOJ)>, None. 


disk drive disk= Specif iec cisk is 


name resident in specified 
Grive. 


disk drive NOT There is no cisk in If apolticable - set 


|READY this crives the disk disk to runs or aliow 
in the cr ive has rect disk to attain proper 
been set to rurs the speeds make certain 
disk itn the drive has disk has a proper 
not come up to proper "lLasel”. 


speecs system coes 
not recognize ciske 


disk drive NOT CMS o- Cisk in this drive Disk must be initiati zed 
STANDARD coes not have a with IN to creete valid 
valid CMS label. CMS tadel. 


cassette drive There 1s neo cassette Check for proper 
INOT READY in this crivés cass~ loadings of cassette 
ette has nct been in drive. 

loadec into drive 

proper ly> 


cassette drive Cassette in specified Use ®?G to create 
UNLABELLED | drive does not have a valid cassette labet. 
: yvyatid label. 


cassette drive Cassette in this drive 

mul ticfile-n ame has the specified 

filename name@e 

disk~-drive — The door of the disk Close the doore 
TEMPORARILY | crive has been oreneds 

NOT AVAILABLE , 


a oo do not have labels corresponding to the correct CMS format and thus will appear “UNLA- 
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PDX (Print Disk Directories) 


This function allows the operator to print the disk directories, disk label and any sector in hexadecimal. 


Format: 


PDX 


The function operates in interactive mode. The operator is prompted to supply the input. 


Output Messages: 


MESSAGE 


DRIVE 


IS DIRECTORY 
REQUIRED <Y OR N> 


ECTOR <4 character 
hex value or null> 


COMPLETE <Y OR N> 


LABEL CORRUPT 


END PDX 
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POSSIBLE CAUSE 


This 18S a prompt 
to the operator 


This 18 a prompt 
to the operator 


The operator is 
prompted to provide 
the hex address of a 
sector to be dis 
playede This prompt 
is repeated until 

a null response 
(just an OCK key) 

1S givene 


The operator is 
prompted to state 

if printing of all 
sectors in the disk 
directory is required 
or onty the first 
sector of each entry 


The check=string 
"SLOINTERNL”™ in sector 
zero has not been found 


end of POX function 


Eater 


SUGGESTED ACTION 


Fnter the device 
mnemonic of the disk 
to be reads for 
examples» DKA 

"yy" if a complete 
directory print 1s 
requireds otherwise 
enter "NN" 


Eater the 4-character 
hex sector address 
followed by OCK1» or 
just OCK1 to terminate 
the function 


Enter "Y™" or “*N™ as 
appropriate 


nones use backup copy 
of disk for normal use 


enter dsired SAU 
function 
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PO (Power Off) 
‘This function allows the operator to terminate the execution of the Stand-Alone Utilities. 
exaniples 
PO 


The utility displays the message 
* * * END STAND ALONE UTILITY * * * 


and causes the B 90 to return to the initial state (PK1 and PK2 lit, refer to figure 11-1). 


RF (Reformat Disk) 


This function provides all the capabilities of IN (initialize), except the disk recording surface test. A CMS 
label and a CMS disk directory are written to the disk. Any information previously contained on the disk will 
be lost. The disk label will contain information supplied by the operator’s responses to the appropriate prompts, 
below, and the directory will be of the minimum size required for the number of files specified. The original 
contents of the disk label will be displayed to record the change and to assist re-input of the same data when 
required. The bootstrap is written back to track “0” in the same manner as for IN. 


Format: 

RF disk-name 
Example: | 

RF ARDISK2 


. Output Messages: 


MESSAGE PCSSIBLE CAUSES SUGGESTED ACTION 
IDATE Frompt allowing ertry Enter date (format 
of RF dat e. MM/DD/YY) 


Prompt allowing Enter number of files 
entry of maximum disk wiit contain 
number of files (less than 28C®). 
cisk will contain. 


SERTAL Prompt allowing | Enter serial number 
entry of disk (6 numerals). 
serial number. 


PACK Prompt allowing Enter disk=name 


entry of disk {up to 7 characters). 
name 

OWNER Prompt allowirg Enter any valid in 
entry of user formation Cup to 14 
defined tinformaticn. characters). 


RESTRICTED | Prompt» requiring Enter "VV". 
a response of “*N*" 
at this t ime. 


‘BOOTSTRAP VERSIC(N RF 
nennenn USE) End of Job (CEOJ) 


END RF 


IPACK diskonane NOT Specifiec cisk™name | Check input Creminput 
ON LINE is not onwline to if necessary)» Check 
computer. for correct disk). 
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MESSAGE 


SUGGESTED ACTIGN 


Dxy DIRECTORY 
|1/0 ERROR 


SYSB 90 NOT PRESENT. 
LOAD CMS BOOTSTRAP 
AND HIT OCK1 TO 

CON TINUE - 
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PCSSTI@LE CAUSES 


A read or write 
error was encou™ 
ntered while system 
was att erpting to 
access directory 

of this cisk. Dir- 
ectory of this 

disk may be corrupt- 
ede 


System failec to 
find a bootstrap 
file from either 
Gdisk or cassette. 


Switch disk to atter=- 
nate drive and re- 
initiate RFs or 


Load another drive 
With disk containing 
C4SB3)3T- or load a 
cassette with name 
SYSB90O0 containing 
C4SB39T as its first 
file. Then press 
JCK1. System witl 
remattemot search for 


C4$8)9T. 


RL (Relabel a disk) 


This function allows the operator to change a disk’s name without affecting the remaining contents of the 
disk. 


Format: 

RL disk-name 
Example: 

RL AP2 


Output Messages: 


MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 


ENO RL RL successful CECJ). Nonee 


Prompt to request Enter new disk name 


operator to enter Cup to 7 legal 
the new disk name. characters). 


PACK disk=name Specified disk is Check tnput ™ resenter 
NOT ON LINE not on tine to the if necessary, 
computer. Check for correct 
cisk.e 


Dxy DIRECTORY A read or write error 
I/O ERROR was encountered white 
the system was attem- 


pting to access the 
directory of the 
specified disk. The 
directory structure 
of the disk may te 
corrupted. 


Warning: 
If RL is used on a disk containing part of a dual pack file, that file will be inaccessible under MCP control. 


There are two ways to prevent this from occurring: 
Remove the file before relabelling the disk, or 
Copy the entire file to a single pack file before relabelling. 


There are two ways to resolve the problem if it does occur: 
Use Stand-Alone Utility (RM) to remove the file, or 
Use Stand-Alone Utility (RL) to relabel the disk to its original name. 
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RM (Remove Disk Files) 


This function allows the operator to remove files from disk. 
Format: 


filename 
RM_ disk-name/ or 
groupname 


Examples: 


To remove a single file: 
RM PR1/PR200 


To remove a group of files: 
RM PR1/PR= 


To remove all files from disk: 
RM PR1/= 


Unlike the RM utility that runs under MCP control, the Stand-Alone RM will remove system software 
(MCPX, COBOLINTX, BILINTERPX, etc.) without a warning message, the same as it removes other pro- 


grams. 


Output Messages: 


file“nane 
REMOVED 


IPACK disk=-name 
INOT ON LINE 


l€itername NOT 
|FOUND 


Dual Pack Files 


POSSIBLE CAUSES 


RM success ful. 


Specified disk is 
not online to the 
computer e 


Specified filename 


RM successful CEQJ); 
Specified group name 
to be removed is not 
on disk. 


SUGGESTED ACTION 


Check input ~ reenter 
if necessary> 
Check for correct disk. 


Check input 7° reenter 
if necessary, 
Check for correct disk. 


None if RM successful. | 
Check input * reenter 
if necesSary. 

Check for correct disk. 


If a file to be removed has an overflow area or another disk volume: 


— if both parts of the file are available, both are removed and the following message is printed: 


file-name REMOVED FROM disk-name-1 AND disk-name-2 


— if the overflow file is not found for any reason or if a file is found with the same file-id but which does 
not match the master file, then the following message is printed: 
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disk-name/file-name IS AN INCOMPLETE DUAL PACK FILE 
A MATCHING OVERFLOW FILE ON disk-name-2 
IS NOT PRESENT. PLEASE TAKE ONE OF THE 
FOLLOWING ACTIONS: 

A) SUPPLY THE CORRECT OVERFLOW PACK 

AND TYPE “A” TO TRY AGAIN 
B) TYPE “B” TO SKIP THIS FILE 
C) TYPE “C” TO REMOVE THE INCOMPLETE FILE 


If option “A” is selected then either the complete file will be removed or the above prompt will be repeated. 


If option “B” is selected then the following message is printed: 
fileename NOT REMOVED, PART OF DUAL PACK FILE 


If option “C’’ is selected then the following message is printed: 
file-name REMOVED ONLY FROM disk-name-1 
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WS (Warm Start) 


This function causes a “‘branch” to the warmstart routine stored in the Read Only Memory (ROM) of the 
machine. It will cause the CMS operating system (file-name MCPX) to be loaded from disk into memory. 


Operating Procedure: 
Type “WS” then press OCK1. Wait for PKs a 4, 5, and 6 to be illuminated. 
Press PK3. 


Enter today’s date in the format: 
MM/DD/YY 
when prompted to do so. 


For further information, refer to the section headed “Loading the MCP’’. 
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LOADING THE MCP 


(This process is also called the “‘warmstart procedure’). 
The B 90 MCP code file is named ““MCPX”’. 
From the CMS Bootstrap Mode (PK3 to PK6 lit), depress PK3. 


The bootstrap will search for a disk file called ““MCPX’’. The search for the MCP procedes as follows: 
bottom drive of highest-channel disk unit 
top drive of highest-channel disk unit 


bottom drive of lowest-channel disk unit 
top drive of lowest-channel disk unit 


For failures in the search, see below, System Load Errors. 


If the MCP search is successful, the MCP is loaded to memory and MCP initialization takes place. The activity 
during this process can be distinguished on the D-lights. 


The initial part of the MCP is loaded (D2 light flickers). 
The console printer is initialized (if one exists). 


AVR (Automatic Volume Recognition, see below) is performed on all peripherals (D2 flickering with D4 and 
D7 on). 


For mini-disks, you will hear the disk start to click. 
For cartridge disks, AVR procedures are very quick. 


The system will print on the SPO (console or self-scan, according to data in the SYSCONFIG file) an MCP 
version message, followed by a list of on-line peripherals that are powered up. 


NOTE 
The version of the MCP is identified by mark/level/patch numbers. For example, — 
version 3.02.27 is mark 3, level 3.02, patch 3.02.27. A new software release is de- 
noted by a higher level number (for example, 3.03). Within a release, higher patch 
numbers indicate improved versions of that level. For example, the application of 
two patches to 3.02.27 will create an MCP version 3.02.29 (see PATCHMAKER 
for details of how to patch MCP files). 


The system will request the date. Depress the Ready Request button and verify that the ON, READY and 
ALPHA lights are lit. | 


Enter the date as requested, followed by OCK1. (Leading zeros are optional). The system prints a date mes- 
sage. 


The MCP automatically loads the program SYS-SUPERUTL (D2, D3, D4, D5, D6 and D7 on). 


If logging is specified in the SYSCONFIG file, the message 
“COMMENCING LOG FILE CONSOLIDATION” 


is given, and the TL utility is loaded (D2, D3, D4, D5, D6 and D7 on) and executed (D2 flickering with D4 
and D6 on). At end of TL execution, the message 


“TRANSFER COMPLETED” 
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“COMMENCING LOG FILE REALLOCATION” 
“LOGGING IS INITIATED ON MM/DD/YY” 


is given, and SYS-SUPERUTL creates new log files (D2, D3, D4 and D5 on). 


Optionally, (depending on SYSCONFIG), a user program is loaded and executed (D2, D3, D4, D5, D6 and 
D7 on). 


The warmstart is complete and the MCP enters idle state (see below). 


It is advisable not to enter system commands until the complete warmstart procedure is over, otherwise con- 
fusion can result. Also, such input is not entered in the system log. | 


Example: 


B90 DCMCP VERSION 03.02.38 79313 
DFA FAC 6 FILES OPEN 
DFE FBS SYS BISK O FILES OPEN 
ENTER DATE aS MM/DD/YY 

OL/OL/B0 
GL JAN 8O 80001 TUE 
COMMENCING LOG FILE CONSOLIDATION 
TRANSFER COMPLETED 
COMMENCING LOG FILE REALLOCATION 
LOGGING IS INITIATED ON O1/01/80 CHCP VER 


% 950 oe, oe, hee whe ett sear ey 
te 686 ot f I LJ N {3 ad LS ‘} n ad a ; 


For possible errors, see System Load Errors, later. 
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BASIC OPERATION UNDER MCP CONTROL 
D-Lights | 


During MCP execution D-lights D1 to D8 give an indication of system activity, as follows: 


mix number of 
Currently executing 
task, value 0 to 15 

(D4 =8, D5 =4, 

D6=2,D7= 1), 

see Mix Number 


If on, or flickering, some input or output activity to disk, cassette, 
printer or other peripheral is being performed. 


If the lights D4 to D7 are all off, this indicates system activity not related to a particular program. For exam- 
ple, AVR procedures result in D2, D4 and D7 being lit. 


If the lights D4 to D7 are all on (value 15), this indicates processing of an input request or loading of a 
program. 


MCP States 


After warmstart is complete, the MCP is either idle or executing a task. The idle state is identifiable by the 
absence of activity on the D-lights. In this state, three distinct patterns can be encountered: | 


D2, D3 only lit: The last activity was a program gone to EOJ. 

D1, D3, D4, DS only hit: The last activity was a SYS-SUPERUTL function CIR, 
LB, LF, PD, RM, KX, or CH). | | 

D1, D3, D4, D5, D6, D7 only lit: The last activity was a system intrinsic. 


When the MCP is executing a task, the mix number is evident in D-lights D4 to D7 (see Mix Numbers). 


At any time when the system is idle, it is valid to terminate the MCP by a PO of the system disk (see PO | 
intrinsic). 


Mix Numbers 


The following table indicates the mix numbers for B 90 activities: 
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mix-numbder task D4-D7 tights 


0 * system activity none 
1°78 user programs various 
9 * AVR D4 » 07 
10°11 utility programs various 
12 + SYS*SUPERUTL C4» CS 
13 MCS D4, DO» D7 
14 | * NOL D4» CS» OF 
15 * program loader/input 
requests D4» DS» DE» D7 


* these tasks are not Shown in the response to the MX intrinsic. 


+ SYS“SUPERUTL iS not Shown in the response to the MX intrinsic 
untess a particular function 1s betng performec: in this case» 
the MX reSpOnSe Shows the name of the functions for example» 

12/RM » or 12/PN 
Normal user programs or compilers are allocated the next available mix numbers in the range of 1-8. Utilities 
are allocated the lowest available mix number from 10 or 11. 


Automatic Volume Recognition (AVR) 


This procedure is carried out if any new media is loaded onto the system. If the procedure fails, the device 
is made not ready. The procedure varies for different media. 


For fixed disk, disk cartridge, Burroughs Super Mini (BSM) disk, Burroughs Super Mini II disk, and ICMD, 
AVR will attempt to read the label. 


For cassette, AVR will search for a CMS label or scratch label, otherwise the cassette is treated as unlabelled. 


In all cases, if transient errors are suspected, Ready the peripheral (see RY intrinsics) re-initiate the AVR 
process. | 


Console Keyboard Under MCP Control 


Under MCP control, the console keyboard may be used to enter system commands to the MCP, or solicited 
data to a program. Commands to the MCP may only be entered when the READY light is lit. Data to a pro- 
gram may only be entered on the alpha keyboard if the ALPHA light, but not the READY light, is lit. Input 
is terminated by an OCK key, or a PK key only if the corresponding PK light is lit. It can be seen that the 
keyboard can exist in one of three states; inactive, system enabled, or program enabled. 


Since an understanding of the operation and behaviour of the keyboard and its indicators is essential, some 
important points are noted here. 


If a disabled key is pressed at any time, or too much data is entered at once, then an error bell will ring 
and the ERROR indicator will light, this error condition must be reset before any further keyboard input can 
be made. 


The RESET key has two basic functions, resetting the error condition explained above, or clearing the infor- 
mation keyed since an OCK or PK key was last pressed. This key is necessarily enabled whenever any alpha 
or numeric key is enabled. 


When some incomplete information has been keyed either to the MCP or a program then it is necessary to 
terminate some information to this destination before entry to the other destination can be allowed. For exam- 
ple, once the ready light is lit an OCK key must be pressed to terminate input to the MCP before any input 
can be keyed to a waiting program. This restriction stands even if the reset key is used. 
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If the keyboard is enabled for input then the D-lights are not lit. 


In order to enable keyboard input to the MCP the ready enable key must be pressed. This key will be ignored 


Snr eo ER OSES AEH NEED A NSS SOEURDN A HD TACIT ESTES 


if the SCL/LOADER routine of the MCP is currently executing a system command or loading a program (D4, 
DS, D6, D7 soy cet" a wait of up to 30 seconds may be necessary before any keyboard input can be. made. 


1 enencenaemena erntane nan BORON 


——— 


or a keyboard error condition will arise. 


If the system is being used with the self-scan screen operating as a SPO device as well as a console file, then 
the ready enable key has an additional function. This key must be depressed in order to prompt the MCP to 
display either the complete screenful of messages on the screen, or the last message on the bottom line of the 
screen (scrolling the other information up one line). When the screen is being used as a console file, the screen 
will display information from the program using it until the ready enable key is depressed. 


If the screen is displaying SPO information, depression of an OCK will return the display to the console file 
information. 


Interrupting the MCP 


It is possible to interrupt the MCP while it is running, this will inform the MCP that some action must be 
taken. The ability to interrupt the MCP is a good indication that the system is running satisfactorily. The only 
conditions where it may prove impossible to cause an interrupt is when the MCP is processing a system com- 
mand or loading a program. Typical interrupts and the consequent processing include: 

Press READY ENABLE button. This will cause the MCP to enable the keyboard for input. 


Opening or closing the serial printer cover will cause the MCP to prevent or allow output to the printer ac- 
cordingly. 


Loading a disk or cassette will cause the MCP to read the label and perform the AVR procedure. 
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MEMORY DUMP TO CASSETTE 


The system must be in the CMS Bootstrap state. If the system had clear-started, depress PK2 to get to the 
CMS Bootstrap state (PK3 to PK6 lit). 


Depress PK4. The numeric light will be lit. 

Insert a write-enabled cassette in any cassette drive unit, and wait until fully rewound. 

Depress the numeric key (1 to 4) corresponding to the drive unit containing the cassette (CTA=1 etc.). 

The contents of RAM will be written to the cassette. During the dump, an indication of the memory address 
being dumped is displayed on the PK lights. At the end of the dump, PK17.to PK24 lights are lit. The cassette 
will be labelled “MEMDUMP/MEMORY”’’. The system will return to the bootstrap state (PK3 to PK6 lit). 


Remove the cassette, clearly mark it with the date and time, and submit it with details of the fault to your 
Support personnel. 


For possible errors, see System Load Errors, below. 


MEMORY DUMP TO DISK 


The system must be in the CMS Bootstrap state. If the system had clear-started, depress PK2 to get to the 
CMS Bootstrap state (PK3 to PK6 lit). 


Depress PKS. The system will search the disk (from which the bootstrap was loaded) for a file called MEM- 
DUMP. | 


The utility GEN.DUMPFL may be used to create a suitable file on the system disk. This must have 
been done before a dump to disk is attempted. It is recommended that for minidisk-based systems a 
spare minidisk is kept with a MEMDUMP file on, and this disk is the only disk loaded when the mem- 
ory dump to disk is taken. This will avoid any possible confusion between MEMDUMP files on differ- 
ent disks. 


The contents of RAM will be written to the MEMDUMP file. At the end of the dump, the CMS Bootstrap 
state will be entered (PK3 to PK6 lit). 


For possible errors, see System Load Errors, below. 


NOTE 
Valid memory dumps will be produced only if the pertinent error condition was the 
last event on the system. Invalid memory dumps will occur if the machine main 
cabinet has just been switched on, or the error condition did not occur under MCP 
control, or PK1 was depressed while in initial state (PK1 and 2 lit). 
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SYSTEM LOAD ERRORS 


The following table of errors cover all symptoms found during start-up of the B 90, warmstart, memory dump 
to disk or cassette, or entry to Stand-alone utilities. 


SYMPTOM POSSIBLE CAUSES SUGGESTED ACTION 
MTR switch in 
wrong position. 


Sequentiat tltighting 
and extinguishing of 
Lights does not occur 
on entry to Initial 
State (for example» 
depressing Load Enable 
button). | 


Set MIR switch to 
*“normalt("™. Neoress 
Load Enabte button. 


Depress shift key. 
Depress PK2. 


Keyboard tocked in 
“shi +¢* mode « 


From Initial State, 
PK2 is ignored 


Depression of PK2 
causes numeric 
Light to be lit. 


PK1 was depressed 
by mistake (this 
clears Memory). 


Depress 
Depress 


Load Enabte. 
PK2. 


Depression of PK2 
causes keyboard 

Lights olus ERROR 
Jtight» to be tit: 


Check on disk uSed- 
Retoad with correct 
disk. Press Load 
Enable. Press PK2. 

See below for diagnosis. 
Note D and PK tights. 
Check that disk 15s 

not at fault by using 
disk in another drive. 
Power cff faulty disk » 
replace with backup 
copy. Request tech 
nical assistance. 


(a) Di through D8 No bootstrap found 

Lit (disk not tnitial=- 
ized correctly). 
Disk media or drive 
fault. 


4Cb) one D light 
not lit» plus 
PK tights lit 


Depress Load Enables 
depress PKi (to clear 
memory)» then depress 
Load Enable agains 
and retrys Request 
technical assistance 
if not successful. 


Memory parity 


ALt keyboard 
indicators flash 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


Warmstart stops Console printer Check forms transport 

with O2 Lit. not ready. cloed- Check printer 
cover down.e Check 
fevers tn correct pos? 
ition. If system does 
not continue» deoress 
Ready then 93CK1. 


Print head does Console printer Open and close cover. 
not initialize at faulty. Repeat warmstart. 
start of warmstart. Request technical 
assistance. 


Memory dump to PK3 was depressed Memory dump cannot 
cassette: System instead of PK4. now be taken. At tow 
warmstarts warmstart to complete. 


Memory dump to Wrong Cassette Correct fault in 


cassette: keyboard drive has heen cassette. Depress 
ERROR Light is lit selected» cassette Reset. Enter correct 
when nUmeric key is not write- numeric key. 
depressed. enabled» or tape 1s 


rewinding. 


Memory dump to Cassette is insert” Correctly insert 
cassette: ERROR ed backwards. cassette. DNenress Reset. 


light is lit Enter correct numeric 
after 10 seconds. key. 


Memory dump to Irrecoverable tape Altow cassette to 


cassette: ERROR error, or accidental rewind» or replace 

Light is tit opening of cassette cassette. Depress 

during dump. drive unit. Reset. Enter numeric 
keys 


No MEMDUMP file found 


Memory dump to Load a disk with a 


disk: Depression on diske MEMDUMF file and 
of PKS causes one depress PK2 then PKS . 
0 tight plus to retry the dump. 


ERROR» to be tit. 


Memory dump to MEMDUMP file on disk Load disk with targer 


disk: ERROR is too smatl to hold MEMNDLMP files depress 
Light is tit memory contents for PK2 then PKS to retry 
during dumo this machine. the cump. 


Memory dump to PK3 was depressed Memory dump cannot 
disk: system warm instead of PK5. now be taken. Attlow 
starts warmstart to complete. 
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SUGGESTED ACTION 
Note D and PK tights. 


POSS IBLE CAUSES 
SAU could not be 


SYMPTOM 
Entry to S.A.U? 


Depression of PK6 loaded from disk: Remove disk» replace 
causes one 0D tight» disk error. with backup copy. 

plus ERROR» to be | Press Load Enable» PK2 
lite | and PKS. See below for 


diagnosis. 


Entry to S.A.U: Console printer Check forms transport 
toad stops with all not ready. closed. Check printer 
keyboard tights tit. cover downe Check levers 
in correct position. , 
Utility should continue. 


Diagnosis of Disk Errors at System Load Time _ 
The disk load routines may fail for two distinct reasons, both indicated by the D lights. 


If all D lights D1 to D8 are lit, then the required information (bootstrap, SAU, MEMDUMP) was not on 
disk. 


If not all D lights are lit, then information found on disk was not reliable due to disk or disk drive errors. 


If all D lights D1 to D8 are lit except one, then the failure occurred during bootstrap load and the exting- 
uished D light indicates the disk unit at fault. 


If only one D light is lit, then the failure occurred during other disk activity (MCP load, SAU load, memory 
dump to disk), and the illuminated D light indicates the faulty disk unit. | 


In addition, the PK lights indicate the nature of the fault. 


Make a note of each D light and PK light setting and take action as in the tables above. The meanings are 
as follows: 


Di channel 0O 
D2 channel 1 


D8 channel 7 


PK1 off = top drives on = bottom drive 
PK2 off = seek complete 

PK3 off = end of cylinder 

PXK4 off = search complete 

PKS off = more details tn PK9 to PK16 
PK6 on = operational 

PK7 off = seek incomplete 

PK8 on = good status 

PKI on = equal 

PK10 on = on cytinder 


PK11 off = illegat seek 

PK12 on = write inhibit 

PK13 off = sector not found 

PK14 off = LRC error (parity) 

PK15 off = titegal command sequence 
PK16 off = device error 


(PK9 to PK16 are significant onty if PX5 is off). 


PK17 = PK24 indicate number of attempted retries before 
error is declared. 
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ERRORS UNDER MCP CONTROL 


The following table of errors covers many symptoms found while using the B 90 under normal control of 
the MCPX, with suggested causes and actions to take. | 


SYMPTOM 


Unidentifiable 
problem 


little happening» 
with D2 ons 03 off 
imost of time 


PK Lights 17 to 24 
flashing with “DF* 
pattern Conveonosoff>» 
onsonsoner0ns0n) 


POSSIBLE CAUSES 


MCP file corrupted 


System thrashings 
too many jobs or 
too targe jobs in 
miXe 


Extended memory 
not correctly 
used. 


hardware disk IC 
error during 
MCP task 


SUGGESTED ACTION 


Use backup copy of 
MCP 


If console not in 
uSe» set GIT ON. 
If Light pattern 
above PK17 to PK20 is ° 
on» one off» ons then 
thrashing is confirmed ° 
D lights 4 to 7 indi-s 
cate mix number of 
executing task- Try ent™ 
ering MX to clear 
condition =: if not 
sucessful» take memor y 
dump and do clear start 
> recuest technical 
assistance. 


Run CONFIGURER and 
warmstart 1f necess@* 
arye 


Take memory dump: 
request technical 
assistance to analyze 
memory dump to find 
disk address for uSe 

in fixing the disk. 

To help find the fault» 
warmstart and run the 
KA utility on the 
system disk before 
executing any programs. 
(See KA» section 4). If 
Shows any “AREAS 
ASSIGNED TWICE" the 
disk directory may be 
bade DO NOT USE THIS 
DISK until recovery 
operations have been 
completed. 


SYMPTOM 


PK Lights 17 to 24 
flashing with “AC" 


pattern Coneoffson» 


offseonsoneo ff sof f) 


or “AD” pattern Con 


of fsons0 f f 20Nn 20N » 
of fx on) 


non-Zero retry 
count on PO of 
system disk 


Logging not taking 
place 


PD» RM function 
not available 


2015228 


PQSS TELE CAUSES 


see below: 


hardware disk I,/0 
error during MCP 
disk directory 
oper ation. 


togical error tn 
disk directory 
due to previous 
fautt. 


Netertorating disk 
performancee 


Improper care of 
removable disks: 


possibly faiture to 
reinitialize disks 


after long use 


SYS*SUPERUTL not 


on systems disk. 


TL not on systems 
disk 


Logging not spec- 
ified in SYSCONFIG 
file. 


No SYS*SUPERUTL 


SYS*SUPERUTL already 


performing one of 
its functions (see 
discussion in 
Section 4). 


SUGGESTED ACTION 


(Take recovery action 
as for “DF” messaces 
above: NO NOT USE THE 
DISK until recovery 


ection is completed.) 


Request technical 
assistance to fix 
the disk. 


Rerun using backup 

cisk = analyZe corr- 
uptec disk using S.A.U. 
PDX function and report. 


Ignore 1f 10 or 20 
during normal 

running in one day. 
Calt field angineer 

1f greater rate 

than usual rate for the 
Site. 


Atl frequently used 
removable disks should 
he cleaned and 
re"initialized 
regularly (for example» 
on a monthly basis). 


Load SYS*SUPERUTL 


to systems disk. 


load Tl to systems 
disk 


Rerun CONF IGURER 
and warmstarte 


Load SYS“SUPERUTL 
to systems disk. 


Check with MX if SYS= 
SUPERUTL is performing 
a function Cmix=number 
12 gives the name of 
the function): wait 
then reenter command. 
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MESSAGE 


POSSIBLE CAUSES 


SUGGESTED ACTION 


Cannot run data 
comm 


Degraded per formance 


System not active: 
programs in mix 

but D-tlight pattern 
does not change, 
keyboard input (for 
examples MX) 15 
possible. 


No NDOLSYS file on 
system disk 


NDLSYS file does not 
correspond to actual 


network on machine. 


NOL-INTERP not pres” 


ent on system disk. 


No MCS program 


Lack of memory due 


to incorrect use 
of Extended memoryr 
wrong SYSCONFIG 


file on system disk. 


Lack of memory due 
to memory fault at 


warmstart time. 


Program Swapoded 
out waiting on 
memory. 


Load NOLSYS fite 
Cyou may need to 
run an NOL compilt- 
ation. 


load correct NDLSYS 
files or recompile 
NDL program. 


Make sure the correct 
interpreter Cfor example 
MICRCPCL) is named 
NOL-INTERP and located 
on the system diske 


Ensure that the correct 
MCS is executing as well 
as any user data comm 
prograiie 


Run CONFIGURER» 
repeat after warm- 
Start. 


Catt field engineer. 


Enter <mix> GO to 
resume program ex? 
ecutton*» if symptom 
persists» program 15S 
too large for avait= 
able memory. 


MESSAGE 


System not active ;: 
programs tn mix but 
D-tight pattern does 
not change? keyboard 
input (for example» 
MX) causes error 
belt to ring 


System initializes 
CPK1 and PK2 Cit) 


PK lights 17 to 24 
flashing (pattern 
other than above) 


Alt keyboard 
Lights flash 
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PCSSTBLE CAUSES 


Console file 
in process. 


Input 


System printer is 
jammed. 


Peripheral Cpossibly 
Line printer) hang 


MCP software error 


Corrupted MCP 
code file. 


Unexpected hardware 
error. 


Unknown MCP error. 


MCP has detected 
an error condit= 
ion from which it 
Cannot recover - 


Memory parity 


report error » 


SUGGESTED ACTION 


Complete inout using 
an OCK key. 


Oonen ard close printer 
cover to initiatize 
orint head. Repeat if 
not successful first 
time. If still not 
Successful» perform 
awarmstarte | 


Enter CL command. If not 
successful» make per 
ipheral ready or not 
ready> switch if off or 
one insert and untload 
spare cassette in cass™ 
ette drive. If this 
fails» take memory dump» 
report fault» and warm 
start. 

Note: never toad or 
unload disk medta» or 
Cassette media which 

are in uses until 

system has returned to 
to initial state. 


Take memory dump» report 
fault» and warmstart.e 


Take memory dump» 
report error» rerun 
cn backup disk. 


Take memory dumo » 
report error» re™ 
warmstart. 


Take memory dump » 
attemot 
to rerun. If stitt not 
Successful» request 
technical assistance. 


Refer to section 

on MCP diagnostic 
messages for further 
details. 


Inittalize system» and 


rerun. If stitl faulty» 
call field engineer. 


8—47 


MESSAGE 


Program load taking 
long time =: keyboard 
disabled and D0 
lights 4 to 7 
flashing. 


Hissing sound from 
disk drive. 


|Noncfunctional 
disk drive. 


I/O errors from 
diske . 


POSSIBLE CAUSES 


Program loaded 
thrashing due to 
tack of available 
memorys too many 
or too targe pro 
grams in mix. 


Disk drive heads 
are damagede 


Hardware fault on 
drive. 


Non-function disk 
drive. 


Crashed disk head. 


Physicat damaged 
disk media. 


Disk media has 
bad areas. 


SUGGESTED ACTION 


Try keyboard input. I f 
this fails» initialize 
system and retry. 


Stop work. Remove the 
disk from the damaged 
drive. THIS DISK IS 
PROBABLY DAMAGED» DO 
NOT LOAD ANY OTHER 
OISk INTO THE ORIVE. 
Catt field engineer. 


Load a good disk on 
cCrive (EXCEPT IF ORIVE 
HEADS HAVE CRASHED)» run 
LS utility. If this 
produces errorss the 
drive is faulty: call 
fiela engineer. 


See above. 


See above. 


Replace with new 
disk media. 


Run CHECK.DISK to report 
on parity errors. Run 

KA to give disk direct- 
ory analysis: If this 
shows AREA MISSING or 
AREA ASSIGNED TWICE» 
send the KA plus recent 
SPO message log to 

field engineer. Run DA 
to give further analysis 
of disk. 


Use btackue disk for 
system files. Re- 
cover any other files 
by attempting to 

CNPY them onemby“~one 
from the corrupt disk 
to a good disk-e 


B 90 DEPENDENT UTILITIES 


The following pages describe those system utilities which run under MCP control but which are relevent only 
to the B 90 CMS software. 
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CONFIGURER (Configure B 90 Software System) 


This utility sets up data in a disk file called ‘“SYSCONFIG” to determine how the B 90 is to be used. The 
SYSCONFIG file must be present on the system disk if any of the software options are to be used, other than 
the defaults given later. The data in this file is examined at warmstart time. Therefore any options specified 
will only be effective after the next warmstart. 


To execute, enter 
CONFIGURER 


The utility runs in an interactive mode, using the console as input. 


“SPO LOGGING REQUIRED Y OR N”. Enter “Y” if a log of SPO messages is to be kept on disk. This 
will normally be required if the SPO messages are sent to the self-scan display where there is no hard-copy. 
If no SPO logging is required, enter ‘“‘N’’. 


“ENTER NUMBER OF LOG FILES’. Enter a number between 3 and 16. At warmstart this number of 
files will be created on the system disk to hold the logs. The names of the files are ““SYS-LOG-01” to “SYS- 
LOG-nn” where “‘n” is the number entered. The minimum is 3 files. 


“ENTER LOG FILE SIZE IN SECTORS”. Enter a number which will be the size of each of the log files, 
between 32 and 16383. The minimum log file size is 32 sectors. Therefore the minimum disk space for log files 
is (32 ox: 3): sectors. 


“INFORMATION FOR WARM START: ENTER ID OF FILE TO BE ZIPPED”. If it is not desired to 
execute a program at the beginning of each warmstart, enter the name of the program code file (including disk- 
id if not on the system disk) to be executed. If no program is to be run, make a null input (just OCK1). 


“ENTER STARTUP MESSAGE”. Enter up to 80 characters, terminated by OCK1, as a warmstart message. 
This message will be displayed at the beginning of each warmstart. If no message is required, just depress 
OCK1. 


“ENTER POWER OFF MESSAGE”. Enter up to 80 characters, terminated by OCK1, as a message to be 
displayed. when the system disk is powered off. If no message is required, just depress OCK1. 


“SPO OPTION SSA OR SPA”’. Enter “SSA” if it is desired to display SPO messages on the self-scan display. 
This will free the console printer to be used entirely by programs with console files. The self-scan can also be 
used by programs. When the self-scan is used both programmatically and as a SPO, the SPO messages are dis- 
played when the ready enable key and OCK1 are depressed. 

Enter “SPA” if it is desired to write SPO messages to the serial printer. This is especially useful if the console 
printer is equipped with more than one tractor, in which case only the bottom left-hand tractor will be used 
by the MCP for SPO messages, and other tractors can be used exclusively by programs with console files. 

“JOB COMPLETED”. This is displayed when the utility terminates. 

Defaults: 

If the SYSCONFIG file is not present on the system disk, the following options are assumed: 

SPO logging is enabled. 

The number of log files is 3. 

The size of each log file is 32 sectors. 


No message is displayed at startup. 


The SPO option is SPA. 
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Output Messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


ILLEGAL NUMBER A number outside Wait for repeat» then 
‘OF LOG FILES the range 3-16 enter correct vatue. 
WaS entered. ' 


ILLEGAL FILE A number outside wait for repeats 
SIZE the range 32716383 promot» then enter 
waS entered. correct value-e 


ILLEGAL 


A file-name enter=- Wait for repeat 
ed does not have prompt» then enter 
the correct format. correct value. 


INV ALID CHARACTER IN Typing mistake Check input and re~enter 
IDENTIFIER identifier when orompted- 


Option has been spec” Wait for repeat prompt» 
ified which is not then enter correct 
one of atlowed values. information. 


l** INVALID SELECTION 
RETRY«* 


PARITY ERROR ON Parity error occur- Investigate cause 
WRITE TO FILE red while writing of disk error. Use 
filename. ERROR information to different disk. 

AT RECORD NUMBER the SYSCONFIG file. Repeat execution of 
number. Utility terminates. programe 


2015228 _ 8—51 


DUMPANALYSE (Analyze B 90 Program Dump Files) 


When a program is DP’ed (see DP intrinsic) a file on the system disk is created with a name DMFILnn where 
: nn is the mix number of the program dumped. This utility provides an analysis of this file, for use by technical 
‘ analysts, printed on the line printer. 


If the dumped program was written in MPL (used BILINTERPX) only the dump-file is required for a full 
analysis. If the dumped program was written in COBOL or RPG (used COBOLINTX), a fuller analysis can 


Format: 


(DMPIL ba) 
DUMPANALYSE disk-name / dump-file-name 


| disk-name / program-name 


Examples: 


To analyze the dump file of an MPL program DP’ed when it was mix number 1: 
DUMPANALYSE DMFILO1 


To analyze a dump file (which had been copied to a new file DPFILE on disk PRB) caused by DP’ing the 
COBOL program AR678: | 


DUMPANALYSE PRB/DPFILE. AR678 


To analyze the dump file created by DP’ing the RPG program RS202P. The program was at mix number 
3 and the code file resides on disk RTB: 


Output Messages: 


MESSAGE | POSSIBLE CAUSES. SUGGESTED ACTION 


**eWARNING#* BIL Program name has 
DUMP FL» SECOND been specified for 
PARAMETER IN a dump fite from an 
INIT.MESS IGNORED MPL program. 


PACK ID TOO | - Diskename exceeds Check input and 
LONG disk-name 7 characters. Util- reventer. 
ity terminates. 


852 


MESSAGE 


FILE I9 TOO 
LONG fitle-name 


INVALID CHARACTERS 
IN FILE filename 


file-name NOT 
FOUND 


INTERPRETER VERSION 
NOT SUPPORTED 
interpreter-name 
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PCOSSTELE CAUSES 


Filecname exceeds 


12 charactes. 
Utility terminates. 


Filte-name or program 
name mis ~spel({ed. 
Utility terminates. 


Dump file or program 
file cannot be found. 
Utility terminates. 


Dump file its corr- 
uoted; Error in con 
piler creating prog- 
ram file. 


SUGGESTED AC TIUN 


Check tnput and 


rewenter. 


Check tnput and 
reenter. 


Check input and 
re-enter. Or make 
file present by 
loading program 
or dump fite from 
backup copy. 


Use backup copy of 
dump files retain 
program code fite 
and request tech 
nical assistance. 
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APTN FN EA MA TONE 


GEN. DUMPFL (Create Empty B 90 Memory Dump File) 


ay oe euneniaaaninmunmianuncanmaduimnemicera ties cia ua acorn 
Uso onsemnanstsTa ry ones saemaceo revOHPUT Haram eareraarer eer rA SSE PSR LESAN IR AUIS NEN 


BES TOS TNT TSE TRYST NEE TE LITE 


The size of. the file i is specified by “number” in the range 64 to 11264. If “number” is not given, the size 


agree 


defaults to actual memory size of the machine in use. 


Format: 


GEN.DUMPFL | number _ | ON disk-name | AS file-name 


Examples: 


To create an empty file called MEMDUMP on the system disk for a B 90 with 80K bytes of memory: 


en SABLE YON SUA GLE PILES AS TEE ONE CIE 


_ _GEN.DUMPEL 80 _ 


To create an empty file called MEMORY.DUMP on disk PRB for a 128K B 90: 


ek ese he mame BR eB Sb o 


GEN.DUMPFL 128 ON PRB AS MEMORY.DUMP 


Note that this file-name_must be changed to “MEMDUMDP” before a successful memory dump can be taken. 
Any existing file of the same name ‘will be removed when the new file is created by this utility. 


Output Messages: 


MESSAGE POSSIBLE CAUSES SUGGESTED ACTION 


SPACE RESERVED 


Successful E€0J None. 


SIZE TO0 SMALL "“number™ is tess Re-input.- 
. than 64. 


SIZE TOO LARGE | “number” is greater Re-input. 
than 11264. 


DISK NAME TOO 
LARGE 


FILE NAME TOO 
LONG 


name 1s greater 
7 characters. 


name is greater 


12 characters. 


Rew1 nput e 


Re~input.e 


GT (General Trace) 


The general trace command is an MCP intrinsic which displays various diagnostic information either on the 
( system console or on the line printer. The general format is: 


Format: 


ON 
OFF 
GT printer-peripheral 
diagnostic-class switch-value 
disk-peripheral 


To turn the trace printing on, with printing on the console (SPA) enter 
GT ON 


To direct the diagnostic printing to a line printer, specify the printer peripheral. For example 
GT LPA 


Note that the trace must also be turned ON in this case. The trace will be interleaved with any program : 
printout. 


To turn the trace off, enter 
GT OFF 


To display the cumulative number of retries performed on a disk unit since the last warmstart, specify the 
_ desired peripheral. For example, 


GT DMA 
The general B 90 machine code trace is implemented as follows: 


Each trace point is identified by a diagnostic class and a diagnostic value. The class is one of 16, identified 
by a hex digit (0-F). This identifies the system function being performed, as follows: 


Open/close file hancdlirg rcutines 

Indexec file hanaling 

Accept/display routones 

Intrinsic functions (fcr examples SORTINTRINS) 
Automatic volume reccgrition (AVR) routines 
BAILIFF (task handling MCP recutine) 

Disk space allocat e/ceaitccate routines 
Interoreters CBILINTERPX» COBOLINTX» NDL.INTERP X) 
MCF communicate handler (MCH) 

Virtual memory CVM) routires 

Tesk control routines (fcr examples SAILIFF) 
I/Q master interrupt hardler (MIP) 


a 
~ 


eso OS BpeOwN oO 


2015228 | |  -g 55 


The diagnostic value is a hex number (0-F) giving a measure of depth of trace required (0 is least significant, 
F is critical). 


The GT command allows the storage of a switch-value for each diagnostic class. If the trace has been initiated 
via the GI ON command, then each time a trace point is encountered in the machine code, a diagnostic printout 
will occur if the switch-value for that class of trace is lower than or equal to the diagnostic value of that trace 
point. For example, if a particular trace point had a diagnostic value of C, then a trace point would occur if 
the switch-value for the appropriate class was in the range O-C inclusive. If the switch-value set by the GT com- 
mand was D, E or F, no trace print would occur. 


The default values set at warmstart are: 
trace option OFF | 
diagnostic print directed to SPA 
all switch-values set to F. 


Therefore the only trace prints that will normally occur are the critical ones (diagnostic value F). 


Note that if the trace option is ON the PK lights display the current trace point, whether or not the printing 


takes place, as follows: 
PK | PK PK PK | PK | PK PK | PK 
17 | 18 19 20 21 22 23 24 


diagnostic-class diagnostic value 
in binary in binary 
(0000 — 1111) (0000 — 1111) 


For example, a trace point with class D (binary 1101) and severity 7 (binary 0111) will cause PK lights 17, 
18, 20, 22, 23 and 24 to be lit. 


The switch-value entered in the GI command must contain two hex digits: 
first digit — switch-value for register diagnostics 
second digit — switch-value for memory diagnostics 


If no options are specified for the GT command, then the current switch-values for each of the 16 diagnostic 
classes is displayed. 


Examples: 


To find the retry count for DMA and DKA: 


GT OMA 
DMA 0 RETRIES 
GT DKA 


GT DKA NOT ON SYSTEM 
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To set the switch-values to CC for interpreters, then interrogate all switch-values, then turn on printing to 
LPA: 


GT B CC 


GT 
DIAG SWITCHES FF FF FF FF FF FF FF FF FF 
eoeoeeF F FF CC FF FF FF FF 


GT LPA 
GT ON 


Note that only the disk-peripheral option and the GT command with no further options result in an immediate 
response to the operator. | 


Format of diagnostic printout: 


The format of a register diagnostic message is given here, where each X represents a single hexadecimal digit. 
The hex string is printed on one line. | 


register: AD BO BIFL J K L 
xX xX XXXX XXXX XXXX XXXX 
register M1 M2 WR XxX Y MXA MXB UMRX AD,ESCT 
XX X X XXX X XX XK X XXXXXXXK KKXXXKXXKXXKX XXXKXX XX XX x XX X XXX X 


The diagnostic class and value are given by the AD register (first 2 digits, repeated in first pair of last four 
digits). For example, a DF diagnostic with M1 = 1111 would look like: 


DF KX MMKK KKK KXKK KMKX KKK 


L211 KMKK MRRXK KRHKKKKKK KRM KK KMKXXK KKKKM KRNXX DE XxX 


where x indicates any hexadecimal digit. 


When GT is switched on, system fatal errors (which would normally result in a set of PK lights 17 to 24 
flashing) are reported as a diagnostic printed message followed by initialization to the Initial state. A memory 
dump should normally be taken to find more information. When GT is switched off, the pattern of PK lights 
17 to 24 that are set flashing on a system fatal error correspond to the value of the AD register. | 
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ND (New Density) 


This intrinsic allows the operator to define the print density on suitable console printers. 


Sands See EN 


c NESE eet NSPE TAS RIE TAS TE ASS SSN ST NOIR ie sete xan es 


ND peripheral density 


PREP RA aS EST REL SAS ETSI IN AT ME NEU AERA RG TESST AR TUES RE aR gE ENS SR RIN OT art a | 


The density field is a single er which specifies the density as follows: 


A. The greatest number of characters per inch available on the printer. 


Sem ET spine 
nO ATR PEDIC EGE EPISODE LE LEED LEER DERE I TOLL IDES AE LLP CL ELENA NLS REALGM ATCO EEE LEO SE ET LES EL LET COP LOE IE EEE CREDO ELLE EEA LEE I 


B. The second highest number of characters per inch. 

and so on. 
1. The greatest number of lines per inch available on the printer. 
2. The second highest number of lines per inch. 


and so on. 


Examples: 


ND SPA 1 
ND SPA B 


When the number of characters per inch changes, the operating system will adjust the values of page width 
and offset (previously set by an FD command or by default) so that any subsequent output is restricted to the 
part of the platten available with the previous density. The page height will be adjusted when the number of 
lines per inch changes. 


The new density, together with the adjusted values of page height or page width and offset, are recorded 
in the system configuration (SYSCONFIG) file and are remembered across system shutdown and warmstart. 


At warmstart, if any inconsistency is found between the system configuration file information and _ the 
capability of the current printer, then the system configuration file information is ignored and default values 
are used. The system configuration file is unaltered. 


The densities available on different printers are as follows: 


PERIPHERAL DENSITY VALUE 
120 cps console printer 15 characters per inch A 
) 10 characters per inch B 
\ 90 cps console printer 15 characters per inch A 
10 characters per inch B 
8 lines per inch Nt 
Z 


| 
6 lines per inch 
‘ 
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Output Messages: 


input NOT 


POSSTBLE CAUSE 


(1l)the specified 
density value exceeds 
the number of options 
available on the 
configured console 
(2)the printer 15 

In use 


(3)the mnemonic 15 
incorrect 


The specified 
peripherat doe3 
not exist 


SUGGEST. O- ACT ION. 


Cl)denter correct 
input 


C2)watt until program 
has closed tne console 
file 

correct the input 

and reventer 


Correct the 
and rewenter 


mnNput 
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PATCHMAKER (Patch B 90 Machine-Code Object Program Files) 


This utility reads a file of patches from disk or cassette or from console keyboard input and patches a ma- 
chine-coded system software item. Stringent conditions are enforced to make the patch, including the necessity 
to apply each patch in the correct order. All previous patches must be applied before making the next patch. 


Note: it is essential that an unused copy of all micro-coded software items is retained for patching. It is not 
possible to patch a B 90 MCP that has been used in normal B 90 operation. This is because certain MCP tables 
included in the code file are modified during operation. This modification would cause the check digit calcula- 
tions in PATCHMAKER to fail. The Stand-Alone Utility (SAU) COPY function may be used to create unused 
copies of all system software for patching purposes, and also to create backup copies of patched software. Files 
on the system disk cannot be patched: they must reside on a user disk. —_ 


To execute, enter 
_PATCHMAKER 


The utility runs in an interactive mode. 
The utility displays on the SPO: “IS PATCH FILE TO BE ENTERED FORM CONSOLE” 
and_waits on an ACCEPT. 


If the operator enters 
AX_mix-number_ YES 


then the cancels file_will be opened. Any other response causes the utility to ask, via displays on the SPO, 


asteruicenancen se etre 


if the file containing patches is on a cassette: if the response is ‘“YES” a tape file named “PATCHES” is re- 
quired, and any other response requires a disk file on the system disk named “PATCHES”. 


If a console file is opened the utility displays 
(“2DATA PATCHES 
pasted WHETHER PATCH FILE IS TO BE 
(OUTPUT ON CASSETTE OR DISK” 


The operator may enter, via an ACCEPT, either “CASSETTE” or “DISK’’. Patches entered subsequently 


servant sete a nee NMA FH ire Rm OM MY ern ani nec RS mesg 


on the keyboard will be written to the specified medium. 


The utility displays 
“ENTER PATCHES NOW” 
The patches must be entered via the keyboard from the hard-copy provided. The characters and terminating 
keys must be entered exactly as supplied, although spaces are not significant and may be entered as found con- 


venient. The utility will ask for resubmission of lines which are obviously incorrect. 


If correct, the message 
“PATCHES HAVE BEEN ENTERED CORRECTLY 
“29END PATCHES” 


is given. 


When the correct patch has been entered, the utility displays on the SPO 
“TS PATCHING NOW REQUIRED” 


and waits on an ACCEPT. 
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If the operator enters anything other than 
AX mix-number YES 


then the utility will go to normal EOJ. If the operator enters “YES”, then patching will be carried out. 


The utility displays | 
“ENTER DISK IDENTITY OF FILES TO BE PATCHED”. 


and waits on an ACCEPT. 


The operator must enter the disk name of the disk on which reside all the software files to be patched. This 
must not be the system disk. 


The utility displays 


“FILE filename BEING PATCHED, 
TO BE SAVED AS ” 


and waits on an ACCEPT. 


The file-name is the name of the file to be patched, which is generated from the patch itself. This file must 
be present on the disk specified earlier. The operator must enter the new name for the file after it has been 


RET IL UN ATURE RNAS UES HSN Beh OREN PEN AT IOROS ROR A NET RR RRR AN 


patched. The patched file will be retained only if the patching is successful. 


Checksums are computed and verified before and after patching. If the utility goes to EOJ without displaying 
any error messages then the patching has been successful. | 


Output Messages: 


MESSAGE | POSSIBLE CAUSES SUGGESTED ACTION 
ERROR IN PATCHES Keyboard input Check keyboard input 
| ENTERED = RUN has been made with hard-copy» reo 
ABORTED in error. execute utility. | 
PATCHES TO fite- Successful patch- Make backup copy of | 
namew1 SUCCESSFULLY ing run. filesname-2 Cunused 
| ACCOMPLISHD AND patched file) for future 
{SAVED IN file- patching. 
name-2 
INITIAL CHECKSUM Wrong software Remexecute utility with 
DISCREPANCY file has been correct input file. 
: submitted for 
patching. 
Other error mess Wrong input files Request technical 
ages other serious soft- assistance. 


ware errors. 


Note: the device kind of the utility’s console file may be modified via the MODIFY utility to one of KB, 
KD or KP if required. The internal name of the console Ug is THREADS. | 
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PMB90 (Analyze B 90 Memory Dumps) 


( This utility is an interactive program which produces a formatted print of the contents of a memory dump 
1] tape or disk file produced by the memory dump feature of the B 90 bootstrap ROM. The tape must be labelled 
|) “MEMDUMP/MEMORY” or the disk file must be named MEMDUMP on the system disk unless otherwise 
(| specified to PMB90. 


The utility requires the following files on the system disk: 
PMB90 — object code file | 
PMBHELP - data file of prompt messages 
PMBERROR - data file of error messages 
PMBM.xxxxx — data file for information on MCP xxxxx 
PMBO.xxxxx — data file for more information on MCP xxxxx 


The x values vary with each release: the files provided with each release must be used with that release, other- 
wise incorrect analysis may be made. 


Starting the Utility 
The utility can be executed with a number of options in the initial message. The format is as follows: 


Format: 


AX 

SET.SCREEEN number number 
PMBS9O MEMORY hex- number 

LIST 


GET file-name 
ON disk-name 


The meaning of these options is as follows: 


ene AYMARA ALTAIR 


The program will use the SPO via DISPLAYS and ACCEPTS to communicate with the operator. If this op- 
tion is not specified the console will be used for communication. 


SET.SCREEN 


This option sets the screen page and line sizes from the numbers specified. These must be set if the DISPLAY 
option is used (see later). The input medium is the console keyboard but echoing of input is on the self-scan 
screen. 


MEMORY -*) Nov usage | 
If this option is specified, the program will read only the first part of the memory dump, up to the byte given 


by the hexadecimal number. Note that use of this option could cause the program to fail on certain print options 
if the analysis requires a part of the dumped memory that has been excluded. 
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LIST 


This option will list the contents of the unanalyzed memory ump during the initial reading of the dump by 
the program. The list is in groups of 4096 (4K) bytes. 


JGEL. 


This option can be used to specify the name of the memory dump disk file. If not used, the file ‘“‘MEM- 
DUMP” on the system disk is opened. If this file is not present, a cassette labelled We eaten pone 
will be opened. 


ON 
This option can be used to specify the disk on which resides the memory dump file, if not the system disk. 


Using the Utility 


The analysis takes place in an interactive manner. All the available options and instructions on how to use 
them are provided in response to the input ‘““HELP’’. Further details on a particular option are provided in 
response to the input “HELP option”. A knowledge of the MCP is required in order to diagnose the reason 
for any particular memory dump. 


The complete dump options are given here in “railroad diagram” format, with further details later. 


PRINT : < print-option > 
DISPLAY 
CHECK < check-option > 
AS tid ON <mfid> 
SAVE 
PATCH yo > 3 << address > ‘7 < hex-addr > 
NEXT 
END | 
BYE 


PRINT 


This option specifies that output from the following list of <print-option>s is to be printed on the console. 


DISPLAY 


This option specifies that output from the following list of <print-option>s is to be displayed on the self- 
scan screen. In this case the SET.SCREEN parameter should have been used in the initial message. 


CHECK 


The two <check-option>s are MEMORY.LINKS and ALL.MEMORY. The MEMORY.LINKS option gives 
a print of all memory links from the initial po (PTRX) until the end of the chain or an inconsistency is 
reached. 
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SAVE 


This option enables a copy of the dump (patched if required) to be made on the specitied disk with the specified file-name. 
PATCH 


This option enables invalid areas of memory to be patched in the dump, to enable PMB80 to continue its analysis. 


The <page-option> may only be ONE. The <address> is four hex digits, and the <hex-addr> may be from 
I to 16 hex digits. 


END, BYE 
These alternative options cause PMB80 to go to normal EOJ. 


The format of <print-option> is as follows: 


ALL.MEMORY 

> GLOBAL 
C.TABLE 
ESCT 
DIAGNOSTICS 

>» TASK.TABLE 

MEMORY.MAP 
MEMORY LINKS 
< page option > VMWA 
GWA 
SCL 
SAT 
MIX 


OL 
DATA.COMM.AREA 


< device option > 


TASK 3 
< task-name > 
< mix-number, 0-15 > | 
| a < wa option > 
CURRENT 
HEX pace Option < start address > =< length > 


864 


ALL.MEMORY 

This option creates an analysis of fixed MCP data areas, configuration table and task table if present, all pe- 
ripheral handler tables, memory links and analysis of all locked slices in memory plus all overlayable code and 
data segments present in memory at the time of the dump. 
GLOBAL 

This option creates an analysis of the fixed MCP data areas only 
C.TABLE 

This option gives a print of the configuration table if it was in memory at the time when the dump was taken. 
ESCT 

This option gives a print of the mix table (execution scan priority table). 
DIAGNOSTICS 

This option gives a print of the MCP’s diagnostic buffer area. 


TASK.TABLE 


This option gives further analysis of the mix, if the overlayable task table was present in memory at the time 
when the dump was taken. 


MEMORY.MAP 

This option provides an analysis of the layout of memory. 
MEMORY.LINKS 

This option analyzes the layout of the overlayable area of memory. 
VMWA 

This option gives a print of the virtual memory work area only. 
GWA 

This option gives a print of the Global work area only. 
SCL 

This option prints the keyboard buffer only. 
SAT 

This option gives a print of the Slice Address Table only. | 
MIX 


This option gives a selective analysis of parts of the dump relating to the tasks running at the time of the 
dump. 


OL 


This option provides a selective analysis of peripheral configuration information. 
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DATA.COMM.AREA 


This option prints the areas of memory relating to data communications. 


PHT 


This option gives a print of selected Peripheral Handler Tables. If the <device-option>s are absent, then all 
peripherals attached to the system at the time of the memory dump are analyzed. Allowable values for <device- 
option> are: 


CX — Channel Expander 

LP — Line Printers 

SP — Serial (console) Printer 

CT - Cassettes 

DK —- Cartridge Disks 

DF — Fixed Disks 

DM —- BSM Disks 

KB — Keyboard 

SS — Self-Scan 

ADC - Asynchronous Data Comm Controllers 
SDC - Synchronous Data Comm Controllers 
DI —- ICMDs 

SDI -— BSMII Disks 


SLICE 
This option provides selective printing of locked slices of memory or of data segments. The <slice-option> 

may be either a ‘‘slice number” in the range 0-45 or one of the following names: 
DISKDDR 
LPDDR 
PANDDR 
KBDDR 
CASSDDR 
SENDDR 
CONSOLE 
INXS 
SCREENSN 
SUSN 
INITIALIZE 
ADCDDR 
SDCDDR 
OPENCLOSE 
DCCH 
SPO 
CONBUFSN 
SCLBUFSN 
ICMDDDR 
OCOMSN 
DIAGSN 
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TASK 
This option prints the contents of a Task Control Block (TCB). 


The <task-name> may be one of 
NDL 
MCS 
BAILIFF 
SCL 
LOADER 


The <wa-option> may be one of 
— MPLII 
BIL 
COBOL 
RPG | 
SORT 
NDL 


HEX 


This option provides a print (or display) in hexadecimal and byte format of selected parts of memory. The 
<start address> is a four-hex-digit number and the <length> is also specified as a four-hex digit number. 


Example: 


To obtain a complete memory dump print on the console printer: 
PMB90 (OCK) 
PRINT ALL.MEMORY (OCK) 


To obtain a dump of the data comm buffers, plus the data comm controller device-dependent routines, plus 
the MCS and NDL task tables: 


PMB90 (OCK) 

PRINT DATA.COMM.AREA (OCK) 
PRINT PHT ADC SDC (OCK) 
PRINT TASK MCS NDL (OCK) 


Note: 


When submitting memory dumps for analysis, it is helpful if some preliminary analysis has already been per- 
formed. The following option is recommended: 


PMB90 
PRINT MIX OL MEMORY.MAP MEMORY .LINKS GLOBAL PHT TASK CURRENT 


Always provide the MEMDUMP file on magnetic media even if this preliminary analysis has been performed. 
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-POWER OFF 
Logically power off all user disks (see PO command if under MCP control, or SAU PO command if under 
SAU control). 


Logically power off the system disk (see PO command if under MCP control). Wait until the system returns 
to the initial state, that is PK1 and PK2 are lit. | 


If the PO command cannot be used, due to some system error, then the system should be halted by pressing 
the Load Enable button, causing the system to return to the initial state with PK1 and PK2 lit. 


Remove all removable disk media. 
A mini disk can be removed immediately the unit door is opened. 
A disk cartridge can be removed only when the red stop light is lit, assuming that the drive is func- 
tioning correctly. | 


Power off the disk units (failure to remove disk media before this, may result in subsequent media corrup- 
tion). 
Remove all cassettes from the system. 


Power off the main cabinet (this must be the LAST action after all peripherals have been switched off). 


Note on disk removal: 


There are only two situations when it is valid to remove a disk: 
where the MCP is not running and the disk is not in use. 


where the MCP is running, but the disk is a user disk which is logically powered off after using the 
PO command: note that the PO command does not cause a disk to become logically powered off if 
it is in use, but the PO will be completed only after all activity on the disk is complete. 


Note on power failures: 


If the main cabinet is switched off accidentally (for example, by power failure), remove all disks and cassettes 
before it is switched back on. | 
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SECTION 10 
B 1800/B 1900-DEPENDENT 
SYSTEM SOFTWARE 


TO BE PROVIDED 


APPENDIX A 
COMPLETE RAILROAD DIAGRAMS 


This appendix gives the railroad diagrams for all the CMS-common intrinsics and utilities, including SORT and CO, in 
alphabetical order. These diagrams give the complete input message formats, for ease of reference. 


For details of the meaning of these messages, refer to the text. 


In the following diagrams the <ex-option > is defined as : 


EX < disk-id > en Sf 


and < file-name > is defined as : 


ff Zdisid ss “es yy , < file-id > ——_—_> 
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AD intrinsic 


a / <prog-name > - 
BD cree << MIX > < peripheral > —_—> 


ADD utility 


< ex-option > 


LD * < file-name > 
ADD < load-spec > vy 


< load-spec> is defined as : 


4 TO <disk-id > | < file-id > <BOTH> 


# FROM < tape-id > 


< group-name > 


AMEND utility 


* < file-name> 


< ex-option > 
‘ [ov AMEND < file-name > 


AX intrinsic 


AX 


/ <prog-name > 


CH utilit 


* < filename > — : 
CH ; 


< ch-spec > 


<ch-spec> is defined as: 


<DATA> | 
< group-name > [oy TO ——<group-name 
sO <DATA> 

| < file-name > a TO 


< file-name = 
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CL intrinsic 


< printer peripheral > 


< tape peripheral > 
CL —_——> 


< self-scan peripheral > 


<ICMD peripheral > 


CHECKADUMP utility 


| * < file-name > 
-< ex-option > fv 
en re < tape-id > WITH - <disk-id > 


CHECK.DISK utilit 


| < ex-option > | \ [oo 
CHECK.DISK < disk-id > 


CO utility 


ex-option 
Ee , CO (*) 


ESTART 
MX 
CLEAR 
< CO-spec-1 > ia defined as : 
<disk-id> / < program-name > 


< CO- spec-2> is defined as : 


< compiler-option > 


PRINT 


| <message-statement > 


FILE 


FI 


()indicates the allowed postions for macro cells 
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<CO-spec1> —— (©) —— <cCO-spec-2> 


< mix > 


< mix > 


ALL 


< patchfile-statement > 
< sourcein-statement > 
< sourceout-statement > 


< workfile-statement > 


< printout-statement > 


< line-number > 


LL < disk-id >/ v. compiler-name>—> 


CO utility (Continued) 
The < compiler name> is defined as : 


RPG 


RPGXREF 
COBOL 
MPL 

OPTLIST 


The < compiler-option > is defined as : 


SYNTAX 
SY 
LI 
LIBRARY 
SAVE 


GO 


The < message-statement > is defined as : 


: MESSAGE — < message-text > —_—_—_> 


< patchfile-statement > is defined as : 


1 : NAME <file-name> —— 


MFID — <disk-id> — 


——~ PATCHFILE 


sf 1 FID ——<fileid>—-—_-— — 
1) : DEVICE — < hardware > 
Le . FILESIZE —<integer > ——— 


A4 


CO utility (Continued) 


< sourcein-statement> is defined as : 


—— SOURCEIN 


< sourceout-statement > is defined as: 


——— SOURCEOUT 


NAME — < file-name > 


MFID — < disk-id > 


FID — < file-id > 


DEVICE — < hardware > 


NAME — < file-name > 


MFID “= <disk-id > 


FID “= = <file-id> 
DEVICE — <hardware > 


FILESIZE — < integer > 


RECORD — < integer > 


RECORDS.BLOCK — < integer > 


< workfile-statement > is defined as : 


<disk-id > — 


—WORKFILE MFID 


< printout-statement > is defined as : 


— PRINTOUT DEVICE —— < hardware >— 
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BLOCK — < inteyer > 


COMPARE utility 


< ex-option > 
pee : , COMPARE 


< comp-spec > 


* L < disk-id >/ Vv. < file-id > 


<comp-spec > is defined as : 


< mfid-spec-1 >— WITH — < mfid-spec-2 > 
7 , 
<gid-spec-1 >— WITH — < gid-spec-2 > : 
< mfid-spec> is defined as : 

<mfid>— / < file-id > | <nb> 
< gid-spec > is defined as : 


, < disk-id > —/— < group-id > DSK —* eid nb> 


COPY utility 


* < file-name > 


t 


< group-copy > 


[ < ex-option> “a 
COPY 


<s-file > TO <d-file> . 
< group-copy > is defined as : 
— < group-name-1> TO —— <group-name-2> —> 
< s-file> is defined as : 
CRD 
1 | MTP 
PTP 
< BOTH > 
1 
< KEY > < r-spec > 
——< file-name 
1 RECORD <nr> 
1 BLOCK <nb> 
1 TAPE.MARKS ———— <nt> 
1 NO.LABEL 
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COPY utility (Continued) 


<d-file > is defined as : 


RECORD 


1 <nr 
1 BLOCK —<inb 
1 FIEESIZE —c<nf> 
1 SINGLEAREA 
1 CRUNCH = 
| EXTENDING 
< file-name > 
CRD 
1 MTP 
PTP 
< r-spec> is defined as : 
< number > 
< r-count > 


< record-key > 


= <record-key > 


~A~10 


CP utility 


< ex-option > < compute-string > 
eee . cP ee = . 


< compute-string > is defined as : 


< integer > 


<integer > 


CREATE utility 


* am < file-name > 


< ex-option > 
[iy CREATE < f-spec > 


< f-spec > is defined as : 


<tab > 


RECORD <nr 

S | BLOCK <nb 

A FILESIZE <nf 
< file-name> N —€ RUNCH 
A 
N 


EXTENDING — < file-name > 
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DA utili 


< ex-option > 
DA < disk-id > / < file-id > 
ONLY 
READ 
-@ - <sector > 
-< record > - 
NEXT 


DS PA ee 
END a 


Ce 


DFH ALL 


NEXT: 
OF <file-id > 
TEMPORARY 


< sector > 
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DA utili Continued 


AVAIL.TABLE 


NAME.LIST 
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“ALL 
AVAILABLE 


BAD 
INVALID 


< sector > 
@ 
NAMES 
OF < file-id> 
TEMPORARY 
- < sector > 
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DC intrinsic 


DD utility | 


FUNCTION — STORE 


< ex-option > 
sntininns Entonantonragiiileblacsditias —< dd-spec>—> 


< dd-spec > is defined as : 


< f-spec> “ < f-spec 
pe. | 
< g-spec > < g-spec | 
disk-id > —/ <file-id > ——> 

<disk-id> —/ “&—<group-id>> 


< f-spec > is defined as : 


<g-spec> is defined as : 


FUNCTION — RESTORE 


<ex-option >] 
_ fo DD— RESTORE — < ddr-spec>—> 


< ddr-spec > is defined as : 


< f-spec > < f-spec>’ 
+ TO ; 
<g-spec <g-spec > 


The < f-spec > and < g-spec > are defined the same way as in STORE FUNCTION. 
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DP intrinsic 


< program-id > —> 


DP <mixno.> 7 / 


DS intrinsic 


DS <mix > —— / 


< program-id > ———> 


DT intrinsic 


< date > < time > 
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DUMP utility | pea, 


< ex-option > 


* < file-name > 
DUMP < dump-spec aN 


< dump-spec > is defined as : 


1 FROM <disk-id> < file-id > 


= TO < tape-id > 
<group-id > 


EX intrinsic 


[fo |. i < real-store > a 
EX < program-id > < text> ——> 
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FD intrinsic 


FD 


SPA <height > ,<width> , <offset > 


FL utitity 


* < file-name> 


’ 


< ex-option> < file-name > 
[| FL 


< group-name > 


FS utility 


< ex-aption > 
oe en FS 


< file-name > 
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GO intrinsic 


/ <prog-id > 
<mix> jo 


GO 


ICMD utility 


<ex-option > 


<ICMD-option> is defined as : 
L.Re— < disk-id > 


< ICMD-option> ———> 


.PG——_ < disk-id > 
FILESIZE ~<number: 


COPY — <file-name> — ICMD — TO — < filename> 


COPY — <file-name> — TO — < file-name > —ICMD 


< file-name > for this utility is defined as : 


<disk-id> / <file-id> 
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IRutlity 


wn |ROm— — < NUMber > —> 


258 | a ee me ee 


* < file-name > 


< ex-option > < file-name > 
os e/a KA 


< group-name > 
< disk-id > / 


DSKAVL 


KX utility | 


KX L < disk-id > Vi < number > oa 


or 


KX 


2015228 A-—19 


LB utility 


————— 8 
a 
LD utility 
See ADD, DUMP, LOAD, and UNLOAD 
LF utility 
roe ae 
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LIST. utility 


* < file-name > 


[_ < ex-option > 7 
LIST 


< r-spec > 


< f-spec> 
< f-spec > is defined as : 
| A 
1 
N 

MTP 

PTP 
1 ‘CRD 

< file-name > 

\ RECORD <rs> 
1 BLOCK < bs > 
1 TAPE.MARKS nS 
1 NO.LABEL 


1 KEY > 


<r-spec> is defined as : 


pocnnensinie ts Ainihil ~aaienemmesonen 


< r-count> 


< record-key> 
— <record-key > 
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LOAD utility 


< ex-option > 


* < file-name> 


<load-spec> is defined as : 


1 TO <disk-id> <file-id> | BOTH> 
v1 FROM <tape-id> - 
< group-id > 


R_utilit 


[ < ex-option > Zn * < file-name> 
LR 


<LR-spec> 


< LR-spec > is defined as: 


< file-name > <A> 


< ASCENDING > 
< group-name > - = 


<disk-id> / 
= < integer > 
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MODIFY utility. 


* < file-id > 


[_ < ex-option > 7Y 
MODIFY 


< m-spec > 


<m-spec> is defined as : 


FILE —<inf>-—— ,-——~<f-spec>—— , 
Saoieae CODE.FILE — < file-name> -—— , + 
PPB <ppb-spec> —, 


< f-spec > is defined as : 


< file-attribute > = < attribute-value > 


PRINT.FPB 
< ppb-spec > is defined as : 
< ppb-attribute > on < attribute-value > 


PRINT.PPB 
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MX intrinsic 


< mix > / < prog-id> 
ope een | NZ 
OL intrinsic 


< peripheral > 
inert oMansnccamsarecsnsanedtliaite 


PD utility 


< group-name > 


PD 
< file-name > 
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PG _ intrinsic 


“———~ PG 


PL utility 


< tape or cassette peripheral > 


[ < ex-option > x 
PL < PL-spec> 


< PL-spec> is defined as : 


SYSTEM 


S 
ERROR 


E 


FROM — <date> 


TO. ——— <date> 
ENTRY ——— <number > 
MIX ——— ~< number > 
INPUT 

OUTPUT 
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PO intrinsic 


< peripheral > —_—_—_— 


—— PO 
PR intrinsic 
A 
ae PR —— < mix no. > / —< program-id > B 
C 
RM utilit 
* < file-name > 
< file-name > <BOTH> 


—— RM 
< group-name > 


RY intrinsic 


RY ———— < peripheral > —_—__> 
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SF intrinsic 


< disk-id > 
< disk-id > / < file-id > 
< file-id > 


SF a << mix no. > — / < program-name > 


SORT utility 


< file-name > 


[_ < wane * 
SORT 


< sort-merge-spec > is defined as : 


< sort-merge-spec > 


< file-statement > 
< key-statement > 


< user-option-statement > 


< file-statement> is defined as : 


FILE ees eee | : 
< I|-file-spec > OUT — < O-file-spec> —> 


IN 


FILES 


< |-file-spec> is defined as : 


DISK 


DISK 
—— <file-name>< PURGE 


CAR 
TAPE 
CASSETTE 


< record-size > 
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SORT 


utility (Continued) 


< O-file-spec > is defined as : 


DISK 
CARD < record-size> 
TAPE 
CASSETTE 
< filename >—< PRINTER 
7 KEYFILE 
TAGFILE 


< key-statement> is defined as : 


ASCENDING 
A 


KEY —<— <loc> — <len> DESCENDING 
D 


< user-option-statement—> is defined as : 
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INDEX 
INPLACE 


MERGE 
NODUPLICATES 


DUPLICATES 
SYNTAX 
NOPRINT 
NODISPLAY 
COMMENT — <comments > 
FILESIZE — <number of records > 
MEMORY — <memory size 
WORKDISK — <disk-name> 


< block-size > 


ALPHA 
UA 
NUMERIC 
UN 
SA 
SN 
SSA 


SQ. utility 


<ex-option > | 
i eee 2 SQ — <disk-id> <SQ-spec> ——- LIST > 


< SQ-spec> is defined as : 
VERIFY 


ALL 
AST ——  < number > 


BEGIN < end address >— 
an a | 
< start address > END 


ST intrinsic 


[ / <prog-name > Y 
< mix > : 


oT 


SV intrinsic 


—— SV —— < peripheral > ——— 
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TAPELR utility 


< ex-option > 
imp heeenaloonneuaetltn -TAPELR < tape-id >> 


TAPEPD utility 


[_ <ex-option > x 
| TAPEPD <tape-id > ———> 


TL utility 


[_ < ex-option oT 
: : : TL < disk-id > / < file-name > RECOVER 


UNLOAD utili 


< ex-option > 


* < file-name > 
UNLOAD ———— pa. |e 


< dump-spec> is defined as : 


1 FROM < disk-id > < file-id > < BOTH> 
[+1 TO < tape-id> 
< group-id > 


UPDATE utility 


<ex-option > * < file-name > 
oe en UPDATE 


<i-file > TO <o-file > 


< i-file > is defined as : 


< file-name 


<o-file > is defined as: 


PILESIZE === fs.> 


-CRUNCH 


XD utility 


< ex-option > : | | 
[ XD —— <disk-id> 7 < address> “7 < length > > 
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APPENDIX B 
EXAMPLES OF PRINTED UTILITY OUTPUT 


This appendix provides sample output from some of the CMS—common utilities described in section 4. 


SPO and console input messages are underlined. Some utilities use SPO display messages for output. Output print listings use 
a printer if one is available, or (for a B 80 or B 800) a console file. Print files can be either labelled or unlabelled : if a file is 
labelled, the name is printed following 


2DATA 
at the beginning of the listing, and 

2?END | 
at the end of the listing (for example, refer to the PL output listing). In this appendix, print files are shown boxed in : other 
output is on the SPO. 


The meaning of the input messages are given in section 4. The utilities are given here in alphabetical order. 
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cra 


CHECKADUMP ARTAPE 


NO DISCREPANCTES BETWEEN DUMP 
eae APE AND DISK SYSTEM 


CHECK. DIGK MYDTISE 


LO/CHECK. DISK < @>MYDISK/SYSMEM 
one PARTTY ERROR WHILE IN READ @e7F 
ERROR NOTIFIED ON READING SECTOR 
LO/CHECK.DIGK < @>MYDISK/SYSMEM 
new PARTTY ERROR WHILE IN READ 2e7F 
| ERROR NOTIFIED ON READING SECTOR 
LO/CHECK.DISK < @>MYDISK/SYSMEM 
eae PARITY ERROR WHILE IN READ @e7F 
ERROR NOTIFTED ON READING SECTOR 


ow a NOT IF TED 


CHECK.DISK ON MYDISK COMPLETED - 


TAPE ART 


DM REAT 
Da E? 
DM READ 
a he 
DM REAL 
wo ed eh att 


ERRORS 


877S TO? 


€—d 


COMPARE FRED WITH MYDISK/FRED 
FRED WITH MYDISK/FRED COMPARED - 1 ERRORS 


DIFFERENCE DETECTED AT BYTE @002F@ 


FRED RECORD 2 IS: 
@O0008 5448 4953 2049 5320 4120 4455 4D4D 5920 4449 4045 2063 5245 4154 4544 2054 4F20"THIS IS A DUMMY FILE CREATED TO 
@O0208 4445 4DAF 4E53 3452 4154 4520 484F 3778 2020 e020 2020 2020 2020 2020 2020 Sor ene ee 
@O0408 2020 2020 2020 2020 2020 2020 2020 2020. 


MYDISK/FRED RECORD 2 IS: 
@OO00R 5448 4953 2049 $320 4120 4455 4D4D 5920 4649 4045 2043 5245 4154 4544 2034 4F20"THIS IS A DUMMY FILE CREATED 10 
@O020R8 4445 4D4F 4E53 5452 4154 4520 4B4F 5720 2020 2020 2020 2020 2020 2020 2020 2020"DEMONSTRATE HOW 
0408 2020 2020 2020 2020 2020 2020 2020 2b20 . : 


DA__MYDISK 


IN BOU DA VERSION [3.01.01] 

DATA CONS 

£ 
CARTRIDGE IDENTIFIER MYDISK SERIAL NUMBER 000009 
OWNERS IDENTIFICATION TIO 
TNITIALIZATION DATE 79130 INITIALIZATION SYSTEM BDS 
PACK CODE 0 ACCESS CODE 
RESTRICTED CARTRIDGE NO INTEGRITY FLAG 0 
BAD SECTOR COUNT 000000 ACTUAL ERROR COUNT 000000 
NUMBER OF CYLINDERS 88/@0058@ UNIT OF ALLOCATION (SECTORS) 1/@01@ 
NUMBER OF TRACKS/CYLINDER 2/R028 NUMBER OF SECTORS/TRACK 52/8208 
NAME LIST ADDRESS 38/@00248 NAME LIST LENGTH 3/@056 
AVAILABLE TABLE ADDRESS 52/RO0208 AVAILABLE TABLE LENGTH 6/8048 
ADDRESS OF FIRST DFH 43/R002BE MAXIMUM NUMBER OF FILES 91/800335@ 


87CST0Z 


DA (continued) : 


DFH OF FRED 


SECTOR: 


44 /@002C8 


FILE IDENTIFIER FRED 
CREATION DATE 79150 
GENERATION NUMBER 0/@00000 
FLAGS BIT 0 = 0 
RECORD SIZE 80/800508 
RECORDS/BLOCK 1/@00018 
HAX FILE SIZE 54/R00360 
HAX AREAS IN USE 1/@018 
REC IN LAST AREA §/800048 


USER COUNTS: TOTAL USERS - 
OUTPUT USERS - 
LOCK ACCESS USERS - 


AREA BIT HAP 


ALLOCATED HERE 
NOT ALLOCATED 


uo 


at 
2-14 0 6 


FILE TYPE @01@ = SOURCE LANGUAGE 
LAST ACCESS DATE 79150 
IMPLEMENTATION LEVEL NUMBER 0/8008 
BIT 2 = 0 
SECTORS/BLOCK 1/#0001@ 
SAVE FACTOR - (299) 
OVERFLOW PACK-ID 9999999 
SPARE BYTES IN LAST RECORD 0/80000@ 
(0) BITS 0-2 
(0) BIT 4 
(0) BITS 3-7 
AREA START AREA SIZE NUMBER OF RECORDS 
ADDRESS IN AREA 


94/RO05ER 94/@00348 4/800048 
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DA (continued) : 
DFH NEXT 
SECTOR:  45/@002D@ FILE IDENTIFIER AMEND FILE TYPE @10@ = S-CODE 
CREATION DATE 78107 | LAST ACCESS DATE 79150 
GENERATION NUMBER = 0/@00008 IMPLEMENTATION LEVEL NUMBER 0/8008 
FLAGS BIT 6 = 0 BIT 2 = 0 
RECORD SIZE 180/@00B48 
RECORDS/ BLOCK 1/@00018 SECTORS/ BLOCK 1/@0001@ 
MAX FILE SIZE 36/80024@ SAVE FACTOR - (799) 
MAX AREAS IN USE 1/@01@ OVERFLOW PACK-ID 2999999 
REC IN LAST AREA 36/800248 SPARE BYTES IN LAST RECORD 6/800008 
USER COUNTS: TOTAL USERS - BITS 0-2 
OUTPUT USERS - BIT 4 
LOCK ACCESS USERS - (0) BITS 3-7 
AREA BIT HAP AREA START AREA SIZE NUMBER OF RECORDS 
ié2 ADDRESS IN AREA 
| 10= ALLOCATED HERE 148/80094@ 36/@00248 36/800248 
2-16 QO 0 = NOT ALLOCATED 
AVATL TABLE AVAILABLE 
AVAILABLE TABLE ADDRESS: 32/800208 LENGTH: 4/@0006@ 
SECTOR — «STATUS LENGTH START ENB (+1) 
32/@0020@ i AVAIL 1038/@040E@ 198/R00Cé6@ 1236/804D4@ 
2 AVAIL 213/@00D5@ 1913/80779@ 2124/R084ER 
3. AVAIL 297/@0103@ 1336/@0538@ 1595/@0463Be 
| 4 AVAIL 354/@0162@ 2216/ROBAB8R 2570/R0A0AG 
37/@O025@ 29 AVAIL 3016/@0BCB@ 2616/@0A38@ 5$4632/8146008 


DA (continued) : 
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NAME LIST NAMES 
NAHE LIST ADDRESS: 


SECTOR 
38/800266 


59/800278 


fowwte 


1 
2 
3 
& 
6 
8 
9 
0 
40/@0028@ =i 
4 


t 
READ @040E 

CHARACTER = 
SECTOR ?1.038/@040E@  0/80008: 
52/0208: 
64/@040@: 
94/@0408: 
128/@080@: 


1.40/@0A08: 


L—-€ 


38/@0026@ LENGTH: 9/@0005@ 


STATUS INDEX DFH ADDRESS 


SYSHEM 00 —- 43/a002Be 
FRED Oi  44/@00ace 
AMEND 02 45700208 
XD 03 46 /@002E8 
COBOL4 0E  — 57/80039@ 
COBOLI 12 61/0038 
COBOLS 13 62/@003ER 
COBOL3 14 63/@003Fe 
COBOL? 16 6500418 
COBOL 1B = 70/@00460 
O01 2345 67 89 ABCD EF O1 23 465 67 89 ABCD EF 
0251 OOBC 7150 4851 OOBD BA4B 3738 5100 BDS1 OOSC 4837 2F84 7189 5FR4 718B 4FOC 
Q P KG kK 78 @ q K7 / 
2E40 OCB4 ODE 400C B40D 9188 OCOD OC51 OOBD 6102 DOF OC42 0251 OOBC 994C 0C77 
a . &@ q 0 B Q L 
0551 OOBD BASB B4F2 SF84 F34F OCB4 FSSF 84F7 FOC O84 FASF 84FB 4FOC 0077 7484 
K 
F65F 84F7 FOC 771D 5100 8C71 SOIF 7763 AC77 0671 S4E2 0802 0251 OBC 5100 8D71 
Q P ? V Q Q 
5058 4B37 4584 FASF 84FB 6FOC 771D 5100 SC71 601F 773D AC77 0471 S7E2 0802 0251 
PL KZN q ‘9 = Wo q 
OOBC 5100 8D71 4058 4837 2851 OOBC 7150 1F77 2051 
q E K7 (Q Pp 2 Q 


E 


DA (continued) : 


READ NEXT 
CHARACTER? O01 23 45 67 8? AB CB EF O1 23 45 467 8F ABCD EF 
SECTORS1039/@040F@  0/@000G: OOBC 7140 4F77 0871 4262 O82 0237 1071 3CE2 0802 O251 OOBC 5100 8D71 405B 4818 
7 < Q Q c kK 
Je/@020@: 2E40 OCB4 ODE 4000 B40D 9188 OCOD OC51 OOBD 6102 BDO4F OC42 O251 OOBC 994C 0077 
. @ . & Q 0 B OQ L 
64/@040@: 0551 O08D BA4B B4Fe SFB4 FI4F OCB4 FOSF 84F7 AFOC ODG4 FASF B4FB 4FOC OD77 7484 
K 2 : e 
94/@040@: F4SF 84F7 46FOC 771D 5100 8071 SOLF 7743 AC77 0471 S4E2 OBO? 0251 008C 5100 BD7i 
2 Q Pp ? V Q Q 
128/@0808: S058 4837 4£84 FASF 84FB 46FOC 771D $100 8C71 401F 773D AC77 0471 57E2 0802 0251 
PE K? N 2 Q “9? 5 iW Q 
1.460/@0A0@: OO8C 35100 8B71 4038 4837 2851 O08C 7150 1F77 2051 
Q C K7 (Q P ? Q 


Is 


EQJU DA 
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KA _MYDISK# DSKAVL. 


WED 30 MAY 79 
INITIALISED 79130 ON 
Gt} CYLINDERS 


%, GO0O0SER 
1336 @0005388 
IS22 BOOOSF eR 
2c1é ROOOBABE 

— 8620 BOOOAICE 


KA_MYDISK/= 


WED 30 HAY 79 


INITIALISED 79150 ON 
2 TRACKS PER CYLINDER 
AREA LENGTH 


te} CYLINDERS 
AREA ADDRESS 


1 o 80000008 
eB 0000208 
3B w000268 
/ 43 anoo0ene 


1236 @0004D46 
1334 @000538@ 
1392 @000570@ 
S22 @O00SF2e 
IS9S @000438@ 
1723 @O006BREG 
1614 #0007148 
1913 @000779@ 
2124 G00084E@ 
2c16 ROOOBARE 
270 ROOOADAG 
2616 BO00ATBE 
2620 ROOOAICE 


USAGE MAP OF MINI DISK MYDISK 
BDS FOR MAXIMUM OF 51 FILES 
2 TRACKS PER CYLINDER 


AREA LENGTH 


1142 @00047648 
34 80000386 
73 @0000476 

354 @0001428 

3012 @OOOBL4E 


USAGE MAP OF MINI DISK MYDISK 
BBS FOR MAXIMUM OF 31 FILES 


32 a0000208 
6 80000068 
5 #0000056 


100 @000044@ ASSIGNED 


SERIAL NO. 000009 OWNER TIO PAGE 1. 


i ERROR COUNT 000000 BAD SECTOR COUNT 000000 


ALLOCATION UNIT 
32 SECTORS PER TRACK 
FILE NAME 


STATUS 


AVAILABLE 
AVAILABLE 
AVAILABLE 
AVAILABLE 
AVAILABLE 


SERIAL NO. 000009 OWNER TIO 


PAGE 1. 
1 ERROR COUNT 000000 BAD SECTOR COUNT 000000 


ALLOCATION UNIT 
32 SECTORS PER TRACK 
FILE NAME 


eres Gree name cose Gene Dube vous Sete tntD 


STATUS 


*#RESERVED 
#AVAIL TABLE 
*FILE DIREC. 


ASSIGNED 
ASSIGNED 
ASSIGNED 


er 


carne ngseacansenetre 


COBOL4 


34 @000038@ AVAILABLE 


130 80000828 ASSIGNED 


COBOL2 


73 @000049@ AVAILABLE 


128 @000080@ ASSIGNED 
91 @Q000SB@ ASSIGNED 
97 @000063@ ASSIGNED 

213 @0000DS@ ASSIGNED 
90 @O0005A@ ASSIGNED 


COBOL 1 
COBOLS 
COBOLS 
COBOL4 
COBOL? 


354 @000162@ AVAILABLE 


46 @O000cER ASSIGNED 
& @000004@ ASSIGNED 


COBOL 
FRED 


S012 @OOOBC4@ AVAILABLE. 


OI-d 


LIST MYDISK/FRED 


REC.NO. FILE MYDISK/FRED ON DSK 


1 HELLO READER 


THIS IS A DUMMY FILE CREATED TO 
DEKONSTRATE HOW 


my 


3 SOME OF THE CMS UTILITIES WORK. 


be THANKYOU. 


LIST MYDISK/FRED A 


REC.NO. FILE MYDISK/FRED ON DSK 


HELLO READER 


. 
ee i 


REC/BLK SIZES 80/ 8&0 WED 30 MAY 79 PAGE 


4B4 S404 C4F 2052494144455 22020202020202020202020202020202020202020 


-2020202020202020202020202020202020202020202020202020202020202020 


CH202020202020202020202020202020 
94484 95520495520412044554D4D59204.6494045204552454154454420544F 20 
S44 54D4F 4E59949241544520484F572020202020202020202020202020202020 
AO202020202020202020202020202020 
ST O4F 4D45204F 4.620544845204540552055544 94049544 94555205 74F 524 BRE 20 
MAO202020202020202020202020202020202020202020202020202020202020 
MAO 20202A0 20202 02020202020202020 
2£0202020202020202020202054484 14E4 BS 94F SS 2E2020202020202020202020 
AOAO2SO2O202020202020202020202020202020202020202020202020202020 
eO2e0e020202020202020202020202020 


REC/BLK SIZES  80/ 80 WED 30 HAY 79 


THIS IS A DUMMY FILE CREATED TO DEMONSTRATE HOW 


SOME OF THE CMS UTILITIES WORK. 
THANKYOU. 


ts 


877S TOC 


II—-d 


LR_MYDISK/= <A> 


WED 30 MAY 79 DIRECTORY OF MINT DISK MYDISK SERIAL NO. 000009 OWNER TIO PAGE 1. 
INITIALISED 79150 ON  BDS FOR MAXIMUM OF Si FILES ALLOCATION UNIT 1 ERROR COUNT 000000 BAD SECTOR COUNT 000000 
8 CYLINDERS 2 TRACKS PER CYLINDER 32 SECTORS PER TRACK 


FILE NAME ACTUAL MAXIMUM RECORD RECS/ CREATED FILE NO. AREA. AREA OVERFLOW 
SIZE SIZE SIZE BLOCK ACCESSED TYPE AREAS ADDRESSES SIZES DISK 
*RESERVED 32 32 180 32. 79150 79150 SYSTEH i 0 @0000008 32{ doooae0@) 
xAWAIL. TABLE b 6 180 32 79150 79150 SYSTEM i 32 80000200 “S'@0000068 
XFILE DIREC. 5 5 180 32 79150 79150 SYSTEM 1 3B 80000260 51@000005@ 
i he 79150 79150 SYSTEM i 43 80000288 451 )80000338__ | 
iEND 180 78107 79150 CODE 780224 i 148. 0000948 34 80000248 
COBOL fF i80 79139 79150 CODE 790519 41 = 2570 @o0oADAG 44 Q00002E8 
COBOLA 128 i28 = 180 1 78339 79150 CODE 780915 1 i595 @000638@ 128 @6000806 
COBOL 99 99 = 180 1 78339 79150 CODE 780525 i 1814 @000714@ 99 G0000638 
COBOL4 100 i00 = 180 i 78339 79150 CODE 780822 1 1236 @0004D48 100 @0000448 
COBOLS 91 91 «180 i 78339 79150 CODE 780830 1 1723 @0006BEG 91 80000580 
COBOL? 90 90 = 180 i 78339 79150 CODE 780915 1 2126 @O00B4ER 90 @00005A8 
FRED 4 54 80 i 79150 79150 SRCELANG i 94 @O0005ER 54 @0000348 
i 78107 79150 CODE 780826 1 184 @000cRae 14 RO0000ER 


XD 14 14 18% 


7I-d 


LR MYDISK/= 100 


LED 30 HAY 79 7 DIRECTORY OF MINI DISK MYDISK  SERTAL NO. 000009 OWNER TIO 


PAGE 1. 


INITIALISED 79150 ON  BDS FOR MAXIMUM OF Si FILES ALLOCATION UNIT 1 ERROR COUNT 000000 BAD SECTOR COUNT 000000 


G3 CYLINDERS 2 TRACKS PER CYLINDER 32 SECTORS PER TRACK 


FILE NAME ACTUAL MAXIMUM RECORD RECS/ CREATED FILE NO. 
SIZE SIZE SIZE BLOCK ACCESSED TYPE — AREAS 
COBOL1 128 1e8 = «180 1 78339 79130 CODE 780915 1 
AREA AREA AREA AREA 
ADDRESSES SIZES ADDRESSES SIZES 


St Dems S WOR 9ECY UmEd GUND GERD GeEh WUD Onde wtbe Ute hte sown tom 


198 Q0000LER 1038 Q00040E@ 1913 @0007798 213 @0000D5@ 
216 @0008Age 354 80001428 2616 R000AZ8@ 3014 @000BCAR 
TOTAL AVAILABLE SPACE ON DISK 4880 80013108 
AREA AREA AREA AREA 
ADBRESSES SIZES ADDRESSES SIZES 


TEMPORARY AREAS 


9°52 Pe MO OPOT COPE SORT TOPE SHR BETT CUED COED EO OED weer enTe 


TOTAL SPACE ON DISK IN TEMPORARY USE 0 80000008 


AREA 
ADDRESSES 


«1595 @00046388 


AREA 
ADDRESSES 


13346 @0005386 


AREA 
ADDRESSES 


AREA OVERFLOW 
SIZES DISK 


128 0000808 


AREA 
SIZES 


257 40001038 


AREA 
SIZES 


8CTCS IOC 


€l—-d 


MOVIE Y 


SDATA CON 


CMS UTILITY: MODTRY CVERSTON 2.01,01 7 


USE PKI FOR HELP 

CODE. FELES (PKI depressed) 

PKL HELP PK@=MODIFY PPE 
CODE. FILES MY DT SR ACO BOLT 
SELECT FUNCTION (PK2 depressed) 

PPB ATTRIBUTE. Eh SLIP PRE So 


PPB ATTRIBUTE (PKS depressed) 
PPE OOF CODE.FILE MYDISK /COBOLA 


TMP WCE VEL. NO me 
PROGRAM NAME: TORO a 
See LANGUAGE HE lew RE ed 
THYTERP. PACK aa CLO 1020101010 
THTERP NAME. “RL TN TEER P : 
COMPILER NAME: "BIL 3.0.2 . 
COMPTIE DATE '7BO9LS" 
EO. SLPRPRE Sos 1 
(CLASS 4. 
TNE. MESS GPE 
EATRY POINT O 
POT. LENGTH GE: 
PST. LOCATON ee 
DST .LENG TH 

OST. LOCATION 
TOB.PA LENG Te ches 
TCBAPA LOCATION ee 
STACK LENGTH 
COB.APA LENGTH Cn 


ar. 
L8G 


COB.PA LOCATION : Cy 


TCB.PE LENGTH . 
TENB LENGTH 
TENB LOCATION i. 
FPB ATTRIBUTE — (PK6 depressed) 

we WCHEER TO 


TEND CON 


PKS=MODIFY 


PPB 


C3 


0 


PR = CODE . PILE 


COFF 3 


PKS=PRINT 


MEL VALLE: 


FPB/PPB 


PKG= TERMINATE: 


vI-d 


MODTEY CODE LET MYPTSE/COBOL., PPB, EOU, SUPPRESS OFF, PRINT. PPB, END 


* MODIFICATIONS SUCCESSFUL. * 


YDATA LP 


CMS UTILITY: MODIFY CVERSTON 3.901.019 


CODE.FILE MYDISK/COBOLT,PPB,EOJS.SUPPRESS OFF, PRINT. PPB,SEND 
PPB OF CODE.FILE MYDISK /COBOL 1 


TMP.WLEVEL NO e 
PROGRAM NAME "EOBOL 1 Z 
S-LANGUAGE PBIL.AREY.IO  % 
INTERP. PACK "OOOOOOO"™ 
TNTERP .NAME | "BILINTERP 
COMPTLER NAME | "BIL 3.0.2 . 
COMPILE DATE "7809S" 
EOI. SUPPRESS G 
CLASS 4 CAD 
INTIT.MESS @QFFR 
ENTRY POINT GQ 
PSTALENGTH | Oh 

PST .LOCATION | rs 
DST .LENGTH | LEO 
DST .LOCATION A 
TCB.PA LENGTH a 
TCB,.PA LOCATION Pe 
STACK LENGTH eer reLe) 
CCOB.PA LENGTH Q 
CCB.PA LOCATION Q 
TCB.PE LENGTH Q 


TFN LOCATION 4. 


TEND LP 


BTTSTO? 


DATA LINES 


WED 6 JUN 79 


TIME 


DATE 


— HHEMHESS «MM/DD/YY 


06/06/79 
06/06/79 


06/06/79 
06/06/79 
06/06/79 


06/06/79 
06/06/79 


— 06/06/79 


06/06/79 
06/06/79 


06/06/79 
06/06/79 
06/06/79 
06/06/79 
06/06/79 
06/06/79 
06/06/79 
06/06/79 
06/06/79 


“END LINES 


MESSAGE 


TYPE 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 


SYSTEM 
SYSTEM 


SYSTEM 


SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 
SYSTEM 


MIX 
NUMBER 


13 
10 


13 


10 


1/0 


MESSAGE 


INPUT 
OUTPUT 


INPUT 


OUTPUT 


INPUT 
OUTPUT 
OUTPUT 
OUTPUT 
INPUT 


OUTPUT 


INPUT 

OUTPUT 
OUTPUT 
INPUT 

OUTPUT 
QUTPUT 
OUTPUT 
OUTPUT 
QUTPUT 


ENTRY 
NUMBER 


pode 


CHS LOG FILE PRINTOUT OF SYS-LOG-HOLD 


RECORD 
NUMBER 


eel senellll peel coed seed coed noel cool coat b © coed & © OE coed ell eed noe eel 2 Ee ET Es 8 


PAGE 


MESSAGE TEXT 


COMPARE FRED WITH MYDISK/FRED 
END OF FILE FRED BEFORE MYDISK/F 
RED - 0 ERRORS 

COPY MYDISK/FRED TO FRED EXTENDI 
NG 

MYDISK/FRED TO FRED BAD ATTRIBUT 
ES 

COPY FRED TO FRED FILESIZE 106 
FRED REMOVED 

FRED TO FRED COPIED 
NO RECORDS FOR COPYING FROM FRED 
COPY MYDISK/FRED TO FRED EXTENDI 
NG | 
MYDISK/FRED TO FRED BAD ATTRIBUT 
ES 

PO DMB 

DMB O.K. 

DMB E/ = FILES OPEN 

PD E/= 

E CONTAINS - 
DELINP CMSCANDE DELINP.O 
ORD.OLD.S NORD.O FACOAT 
NORDO NORDS CUSMAS 
END PD 


91-@ 


SQ MYDISK FAST 2800 LIST 
LARGEST AVAILABLE SPACE IS 3012 SECTORS 


TOTAL AVAILABLE SPACE 15 4437 SECTORS IN 


anadd AREA(S) 


#¥% SO COMPLETED 4#* 


LAGE MAP OF DISK MYDISK BEFORE SQUASH 


FILE NAKE 


AREA FILE 
NB OPEN 


DISK ALLOCATION 


LENGTH 


FROM 


TO 


DATE = WED 30 MAY 79 


AVAILABLE TABLE 
INFORMATION 


REMARKS 


PAGE 1. 


° - ne gem wee mee seen peony A20e OND REND SONG SOND Ute HNED NORD NEES WATE EET GUEE TEED onee atee GENO GuEe ameD ates 
ntautuhd ROO Gane Gn BERD CEES tees bteE EDeE finde REE! EOOU SET SER] GUDS Get GREE CHRP GEES SNCF OEY. Sous OEP) GEES CPE EETD GERD gne Gade UEhe EROS DEES HEED OOO EET SheT Heed Bhet SPE) COND EHUD GERD SUED ENTS ERFF EDN aEEe SET SORE ROTE HOTT ENTS METt nes HOTS APRS OOSD EEE REND Apes HEED GET Gems Onde Guree GEDe Ente pUbe ween ae pee wate oo -_ 


COBOL? 


COBOL? 
COBOL 


FRED 


ee ee a 


ROOOOSER 
R0004D4@ 
@000538R 
#000570@ 
ROO0SF2E 
@O0043BR 
ROOO4BBE 
#0007168 
80007798 
RO00R4ER 
ROOOBARE 
ROOOA0AG 
ROOOAZ8R 
BOO0ES9@ 
ROOOESDE 


@0004D30 
#0005378 
@O0054F@ 
@OOOSF1G 
R000463A8 
@OO04BAG 
@000715@ 
00007788 
BOO0B84DE 


ROG0BA7E 


ROOOADTE 
G000A37@ 
ROOOESER 
ROOOESTE 
QOOLSFFR 


AVAILABLE SPACE 


AVAILABLE SPACE 


AVAILABLE SPACE 


AVAILABLE SPACE 


AVAILABLE SPACE 


AVAILABLE SPACE 


8Z7S 107 


SQ (continued) : 


UGAGE HAP OF DISK MYDISK 


FILE NAME 


COBOLe 


COBOL1 
COBOLS 
COBOLS 
COBOL 
COBOL? 


COBOL 
PRED 


AREA FILE 


AFTER SQUASH 


DISK ALLOCATION 


LENGTH 


FROM 


ROO00DER 
@0004D46 
@000538@ 
@000570@ 
ROO0SF ee 
#000638@ 
@OOO6BRE 
@000714@ 
80007798 
ROOORB4ER 
ROOQOBABE 
ROO0A0AG 
RO00AIEE 
GO00ASLE 


@0004D3@ 
#0005376 
G00054F@ 
ROO0SF1G@ 
BO0043AG 
ROOO4BAG 
#0007156 
#0007786 
O0084D8 
@O008A78 
ROOOA09R 
@000A37@ 
ROOOAZBE 
QOOLSFFE 


BATE = WED 30 MAY 79 


AVAILABLE TABLE 
INFORMATION 


AVAILABLE SPACE 
AVAILABLE SPACE 


AVAILABLE SPACE 


AVAILABLE SPACE 


AVAILABLE SPACE 


REMARKS 


8I- 


TAPELR ARTAPE 


THU @1 JUN 79 TAPE SERTAL NUMBER OO6000 PAIDE 

DIRECTORY OF NRZI TAPE ARTAPE DUMPED ON THU @i1 JUN 7¢ 

PILE NAME ACTUAL MAXIMUM RECORD RECS/ CREATED PLE, 
SiZzk SIZE se ee oe BLOCK ACCESSED TYPE: 


MYF TLE 5 180 1 7PL7e P91 7e KEY 
MYF TLEQQ z iL 2Q 1 79L72A P9172 DATA 
FOP? ?( Lek 1 79ISB POL? 2 DATA 


TAPEPD ARTAPE 


NRZT TAPE ARTAPE <G0000> DUMPED ON THU 2 
ove JUN 79 CONTAINS ~ 

MYFILE MYFILEQQ AVY 

END TAPEPD 


APPENDIX C 
GLOSSARY OF TECHNICAL TERMS 


ADDRESS 


A disk is divided physically into tracks and sectors, both numbered sequentially from zero upwards. These 
‘numbers* are referred to as ‘addresses’. The MCP uses this address scheme to quickly locate data on disk. 


ALPHANUMERIC 


Consisting only of letters of the alphabet plus the ten numeric digits; that is, not containing any other special 
characters. 


APPLICATION PROGRAM 


User program that performs day-to-day functions such as invoicing, printing, inventory reports, etc. 


ATTRIBUTE 
Characteristic or quality. 


BACK-UP 


Term used to describe the method of insuring that copies of files exist to standby as alternatives. 


BINARY-CODED DECIMAL (BCD) 


A method of coding numeric information in 4-bit units representing 0 as bits 0000, 1 as bits 0001, 2 as bits 
0010, up to 9 as bits 1001. For example, the number 1607 in BCD would take four 4-bit units (2 bytes), coded 
as 0001 0110 0000 0111. 


BOJ 


‘Beginning of Job‘ The term used to notify the operator that a program has entered the ‘mix‘ and has just 
started running. 


BSMD 

Abbreviation for ‘Burroughs Super Mini Disk‘. 
BYTE 

One alphanumeric character of data. 


-CHECKERBOARDED 


Term applied to any disk having available spaces of varying sizes scattered about the disk amongst files. The 
term can also be applied to memory in a virtual memory system where ‘locked‘ or ‘save‘ areas are scattered 
through the memory in such a way as to impede getting overlayable memory areas of sufficient size for optimum 
— throughput. : — 


2015228 


CMS 
Computer Management System. A set of interrelated specifications for system software, including high-level 


language compilers, object-code formats, operator interface and data communications, which Burroughs has im- 
plemented on machines of different hardware characteristics. 


COMPILATION DATE 


The date on which a programmer’s source code was compiled : that is, the creation date of the executable 
object program. 


COMPILERS 


‘Group of system programs that convert instructions written by a programmer in a language such as COBOL 
or RPG into a form which can be run or interpreted by the hardware or system software. 


CONFIGURATION 


Term used to describe the arrangement of various hardware devices in a particular system. 


DATA FILE 

A set of information usually or a disk, which is used as data to be input. 
DEFAULT VALUE 

Usually a meaning that a program will assume if not ‘asuniciea otherwise. 
DESTINATION 

Disk to which information is being transferred. 
DISK DIRECTORY 

List, on Track 0, of file names, locations on disk, and sizes. Similar to a table of contents. 
DISK FILE 


Set of information residing on a disk medium, collectively referred to by its name, ‘file-name‘ and the name 
of the disk on which it resides (‘disk-name‘). 


DISK NAME 


Name by which a disk is known to MCP. Every disk medium has a ‘label‘ of information written to it during 
disk initialization, and the disk name is part of the ‘label’. 


DUAL-PACK FILE (MULTI-VOLUME FILE) 


A file that resides on two separate disks or logically defined disks (for example, DKA, DKB). 


EOJ 


‘End of Job’. The term used to notify the operator that a program has terminated. ‘Abnormal‘ end-of-job 
occurs when a program is terminated prematurely due to an error condition. 


C-—2 


EXECUTION 


The running of a program is termed ‘program execution‘. The operator can execute (or start) a program by 
entering the name of the program desired (or disk-name/program if program resides on user disk). When a pro- 
gram is ‘executed‘, it enters the ‘mix‘ and is assigned a ‘mix number‘ by the MCP. 


FAMILY (GROUP) OF FILES 


Two or more disk files having at least the first letter of their names in common. For example, ‘PR020‘, 
‘PRFILE‘, and ‘PASMI‘ are members of a family of files that could be referred to as ‘P—. 


HARDWARE 


Term referring to all equipment on the system. Line printers and disk cabinets are examples. 


HEXADECIMAL (‘HEX’) 


A number system based on root 16, in contrast to common ‘decimal system based on root 10. To provide 
additional symbols, the letters A through F are used, so that counting procedes thus: 0, 1, 2, 3, 5, 6, 7, 8, 
9, A, B, C, D, E, F, 10, 11, 12 ... for decimal numbers 0 through 18 ... 


INTERPRETER 


A system software item used as an intermediate step in the running of a program. Instead of using a compiler 
to transform programs directly to machine instructions which can be run by the processor, a compiler may trans- 
form the program to an intermediate form (called ‘S-code‘). The S-code can be ‘interpreted’ by the interpreter, 
that is, translated into machine instructions that can be run by the processor. 7 


INTRINSIC 


A ‘command‘ used by the operator to direct the activities of the MCP. Intrinsics are actually a part of the 
MCP and therefore will never be seen on a disk file listing or in the ‘mix‘. Examples of intrinsics include ‘DS‘ 
(discontinue the processing of a program) and ‘DT“ (retrieve or change system date). 


KEYFILE 


File used by system as an index to a master data file. 


LABEL 


A small space of disk on tape indicating the medium’s contents, name, etc. A disk label may be created during 
the initialization process, and a tape label is created when the tape is purged. 


MAIN MEMORY 


Circuit boards inside processor where program code and data in immediate use are held. 


MCP (‘Master Control Program”) 


| Program which is the central part of the CMS software system. It handles hardware devices, communicates 
with the operator, and controls processing of programs. 


MIX 


Term applied to the mixture of programs running in a multi-programming environment. A ‘mix-number’ is 
a number which is assigned by the MCP to a program when it enters the ‘mix‘. A ‘null’ mix is when no jobs 
are running. | . 
The program’s name and mix number can be used by the operator to refer to a particular program in the 
mix’. 


¢ 
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MULTIPROGRAMMING 


One processor working on more than one program at a time. Processing can be shared on a ‘round-robbin‘ 
basis, and computation can be overlapped with input/output if there is more than one program ‘in the mix‘. 


ON-LINE 
Term used for equipment or media currently used as part of the system. 
PACK 
Synonym for ‘disk‘ 
PERIPHERAL 
Hardware device used as input or output. Examples are line printer, disk drive unit, console keyboard. 
PURGE 
To erase when disks or tapes are ‘purged‘, their contents are lost. 


SECTOR 


A disk is divided physically into data storage spaces called sectors, numbered sequentially from zero upwards. 
Each sector is 180 characters in length. 


SOFTWARE 

Term referring to programs and files, as distinct from the ‘hardware‘ of the actual machine. 
SOURCE DISK 

Disk from which information is being transferred. 


SOURCE FILE 


A disk file containing statements (instructions) written by a programmer in a high-level language such as — 
COBOL or RPG, before it has been transformed into a runnable program. 


STAND-ALONE PROGRAMS 


Programs that do not run under control of the MCP. In particular, functions of general use to all B80 users 
are held in a disk file called ‘SAU‘(Stand Alone Utilities). Examples include LS (list disk name and sizes), and 
RL (relabel a disk). Loading and execution of SAU is done with no need of the MCP. Refer to Section 8 for 
details. 


STARFILE | 


A small disk file optionally used at the start of most CMS-common utilities. The information in the starfile 
is used to build up the initiating message for the utility, which could also be entered by the operator on the 
SPO. Starfiles are also called ‘macro-files*. 


SYSTEM DISK 
The disk containing the copy of the MCP that is currently in use. 
Note that a user disk may also contain MCP code files, but only the disk containing the MCP that is in use 


since the last warmstart is the system disk. There can be only one system disk at any time during operation. 
System disks cannot be used as’system disks on more than one CMS product (see section 2 for details). 
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SYSTEM FILE 


A disk file which is used by the system software. Special control is placed on these files to minimise the 
danger of accidental removal from the disk (see RM utility). 


SYSTEM SOFTWARE UTILITY 


A program of general use to all users, as opposed to an application program which performs a particular using 
day-to-day tasks, such as invoicing. Examples of utilities include COPY (copy files from one medium to another) 
and RM (remove files from a disk). 


USER DISK 


Any disk available to the system that is not a system disk. 


VIRTUAL MEMORY 


A software technique, implemented in the MCP, of allowing programs to execute (or several to execute to- 
gether) when the total program memory requirements exceeds the amount of memory physically available. Some 
of the executing program’s code and data, which is not in immediate use, is stored on disk media and not in 
main memory. When the code, or data, is required, space is made for it in main memory and the information 
read back from disk. To make space in memory, it may be necessary for the MCP to re-use some memory 
which has previously been used by the program and is not required at this moment. Before re-using memory 
containing data that could have been updated, the MCP writes this segment of memory to the program’s ‘virtual 
memory file‘ on disk. 


This technique also applies to the code and data of the MCP and other system sofware. 
VOLUME 
Synonym for ‘disk*‘. 


WRITE INHIBIT 


To prevent disk on tape media from being written to by a program. The manner in which this is accomplished 
depends upon the medium (see B80 or B800 System Operator manuals for details). 


WRITE PERMIT 


To allow any disk or tape medium to be written to by a program. The manner in which this is accomplished 
depends upon the medium (see B 80 or B 800 System Operator manuals for details). 
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APPENDIX D 
RELATED DOCUMENTATION 


The following manuals provide information concerning CMS System Software: 


Manual Form Number 


CMS ARCS Reference Manual 2012713 
CMS COBOL Reference Manual 2007266 
CMS MCP Reference Manual 2007266 
CMS RPG Reference Manual 2007274 
CMS MPLII Reference Manual 2007563 
CMS NDL Reference Manual 1090925 


CMS Data Communications Subsystem Reference Manual 1090909 
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